home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 16 / qedit208.zip / QEDIT.DOC < prev    next >
Text File  |  1989-07-27  |  249KB  |  5,903 lines
  1.  
  2.  
  3.                                  Welcome to
  4.  
  5.                                QEdit Advanced
  6.                              the "quick editor"
  7.  
  8.  
  9.                         Version 2.07 (December 1988)
  10.  
  11.  
  12.                        R E F E R E N C E   M A N U A L
  13.  
  14.  
  15.  
  16.                                    SemWare
  17.                       4343 Shallowford Road, Suite C-3
  18.                           Marietta, GA  30062-5003
  19.                                (404)  641-9002
  20.  
  21.  
  22.     Copyright (c) 1985-1989 Applied Systems Technologies, Inc., dba
  23.     SemWare. All Rights Reserved.
  24.  
  25.  
  26.     This version of the documentation, software and copyright supersedes
  27.     all previous versions of QEdit.
  28.  
  29.     Specifications subject to change without notice.
  30.  
  31.  
  32.  
  33.                            _______
  34.                       ____|__     |               (TM)
  35.                    --|       |    |-------------------
  36.                      |   ____|__  |  Association of
  37.                      |  |       |_|  Shareware
  38.                      |__|   o   |    Professionals
  39.                    -----|   |   |---------------------
  40.                         |___|___|    MEMBER
  41.  
  42.  
  43.  
  44.  
  45.                                    LICENSE
  46.  
  47.  
  48.  
  49.     This version of QEdit is NOT public domain or free software, but is
  50.     being distributed as "shareware".
  51.  
  52.     Non-registered users of this software are granted a limited license
  53.     to make an evaluation copy for trial use on a private,
  54.     non-commercial basis, for the express purpose of determining whether
  55.     QEdit is suitable for their needs.  At the end of this trial period,
  56.     you should either register your copy or discontinue using QEdit.
  57.  
  58.     What does all this really mean?  If you use this program, then you
  59.     should pay for your copy.  That way SemWare will be able to provide
  60.     you support and updates, and stay in business.  Plus, registered
  61.     users receive additional utilities, additional configuration files,
  62.     update notices, technical support, and, a version of the program
  63.     that does NOT show the opening and closing shareware registration
  64.     screens, and does not require the pressing of F10 to start the
  65.     program.
  66.  
  67.     A QEdit registration entitles you to use the program on any and all
  68.     computers available to you, with the following restriction: If other
  69.     people have access to this program or may use it, then you should
  70.     purchase a site license.  See the following section for information
  71.     about site licensing or quantity discounts.
  72.  
  73.     All users are granted a limited license to copy QEdit only for the
  74.     trial use of others and subject to the above limitations. This
  75.     license does NOT include distribution or copying of this software
  76.     package:
  77.  
  78.       1. In connection with any other product or service.
  79.       2. For general use within a company or institution.
  80.       3. For any consideration or 'disk fee'.
  81.       4. For distribution in modified form; i.e., the file containing
  82.          this license information MUST be included, along with the full
  83.          QEdit documentation.
  84.  
  85.     Operators of electronic bulletin board systems (Sysops) are
  86.     encouraged to post QEdit for downloading by their users, as long as
  87.     the above conditions are met.
  88.  
  89.  
  90.  
  91.  
  92.                            ORDERING INFORMATION
  93.  
  94.     A QEdit registration licenses you to use the product on a regular
  95.     basis. Registration includes notification of updates and telephone
  96.     support.
  97.  
  98.     Individual registrations for QEdit come in two forms.  The first,
  99.     registration only, costs $44 (plus 1.50 shipping).  When received,
  100.     we will send you the latest QEdit diskette, with documentation on
  101.     the disk. Alternatively, if you so specify, we will send you the
  102.     next update of the program, when available.  We also offer QEdit
  103.     with a printed manual. For $54.95 (plus 3.00 shipping) we will send
  104.     you the current version of QEdit, along with a professionally
  105.     typeset bound manual, and a QEdit quick reference card.  Georgia
  106.     residents should include 4% sales tax.
  107.  
  108.  
  109.  
  110.     ORDERS OUTSIDE THE US: Please use your Mastercard or VISA when
  111.     ordering, or send a check drawn on a US bank in US dollars.  We can
  112.     accept non-US currency; however, you must include an additional $25
  113.     to cover conversion and collection costs.  Please include an
  114.     additional $10 to cover postage on orders delivered outside of the
  115.     US.
  116.  
  117.     Educational institutions, full-time students and BBS sysops can
  118.     apply a 35% discount to all prices.  PLEASE include your educational
  119.     institution letterhead (with your title), or a photocopy of your
  120.     most recent registration slip, or the name and number of your BBS
  121.     along with any other relevant information.
  122.  
  123.  
  124. Remit to:  SemWare                                       Order Form  #8907-OF02
  125.            4343 Shallowford Rd, Suite C-3
  126.            Marietta, GA  30062-5003
  127.  
  128.                    *** QEdit version 2.08, July 1989 ***
  129. We offer special prices/discounts on quantity orders, multiple-user
  130. licenses, and dealer pricing.  We also offer student discounts, and
  131. discounts for bona fide BBS sysops.  Please call for details.
  132.  
  133. You can also order by phone using your American Express, MasterCard or
  134. VISA. (404) 641-9002, Mon. - Fri., 9:00 a.m. - 5:00 p.m., ET ONLY.
  135.  
  136. SemWare, please send me (check desired items):
  137.  
  138. ____ QEdit Registration ......................... @ $44.00 ea  $ ______
  139.         (Includes latest version of the program diskette, with
  140.         documentation on the disk.)
  141.  
  142.         _____ Instead of sending me version 2.08, please send
  143.               me the next update when it is available. (Not
  144.               applicable to registration with printed manual.)
  145.  
  146.      Shipping ...............................................  $ ______
  147.         (U.S. and Canada, $1.50; All Other Countries, $5.00)
  148.  
  149. ____ QEdit Registration with Printed Manual...... @ $54.95 ea  $ ______
  150.         (Includes registration, program diskette, reference
  151.         card, plus our new professionally printed, 125-page,
  152.         spiral-bound, indexed manual.)
  153.  
  154.      Shipping ...............................................  $ ______
  155.         (U.S. and Canada, $3.00; All Other Countries, $10.00)
  156.  
  157. ____ Purchase Orders under $100.00, add $5.00 Handling Charge  $ ______
  158.         (NON-PREPAID ORDERS ONLY - THIS DOES NOT APPLY TO
  159.         CASH, CHECK, MONEY ORDER OR CHARGE CARD ORDERS)
  160.  
  161.                                                      Subtotal  $ ______
  162.  
  163. ____ Georgia Residents please add Sales Tax ............ @ 4%  $ ______
  164.  
  165.                                              Total (U.S.Funds) $ ______
  166.                                              drawn on U.S.Bank
  167.  
  168. Payment by:  ( )CHECK  ( )AMEX  ( )MC  ( )VISA  ( )PO# ______________
  169.  
  170.    Name: ____________________________________________________________
  171.  
  172. Company (ONLY if company address):___________________________________
  173.  
  174. Address: ____________________________________________________________
  175.  
  176.        : ____________________________________________________________
  177.  
  178.        : ____________________________________________________________
  179.  
  180. Day Phone: _________________________ Eve: ___________________________
  181.  
  182.  Card #: _________________________________ Exp. Date: _______________
  183.  
  184. Signature of cardholder: ____________________________________________
  185.  
  186.              Prices subject to change without notice.  Current
  187.              prices can be confirmed by calling (404) 641-9002.
  188.  
  189. ------------------------ User comments ------------------------------
  190. I acquired QEdit v2.08 from
  191.         [ ] - Friend                    [ ] - Software product
  192.         [ ] - Computer Club             [ ] - Computer Store
  193.         [ ] - Data Base Service         [ ] - Electronic BBS
  194.         [ ] - Other - Please Specify ________________________________
  195.  
  196. We would also appreciate any input you would care to give concerning
  197. QEdit. If you have any ideas or comments that would make QEdit a better
  198. program, then please let us know.
  199.  
  200. We value your comments!
  201.  
  202. Comments and/or suggestions:
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.                                  DISCLAIMER
  211.  
  212.     Use of this program acknowledges this disclaimer of warranty: "This
  213.     program is supplied as is.  Applied Systems Technologies, Inc.
  214.     disclaims all warranties, expressed or implied, including, without
  215.     limitation, the warranties of merchantability and of fitness of this
  216.     program for any purpose.  Applied Systems Technologies, Inc. assumes
  217.     no liability for damages direct or consequential, which may result
  218.     from the use of this program."
  219.  
  220.  
  221.                                  TRADEMARK
  222.  
  223.     SemWare and QEdit are trademarks of Applied Systems Technologies, Inc.
  224.     MS-DOS is a registered trademark of Microsoft Corporation.
  225.     PC-DOS is a registered trademark of IBM Corporation.
  226.     Compaq is a registered trademark of Compaq Computer Corporation.
  227.     Tandy 1000 is a registered trademark of Tandy Corporation.
  228.     SideKick and SuperKey are registered trademarks
  229.     of Borland International, Inc.
  230.     Wordstar is a registered trademark of MicroPro International Corporation.
  231.     Brief is a registered trademark of UnderWare, Inc.
  232.  
  233.  
  234.  
  235.              CORPORATE SITE LICENSES AND QUANTITY PURCHASES
  236.  
  237.     All corporate, business, government or other commercial users of
  238.     QEdit must be registered.  We offer quantity discounts as well as
  239.     site licensing.
  240.  
  241.     Corporate site licensing agreements allow duplication and
  242.     distribution of specific numbers of copies within the licensed
  243.     institution. Duplication of multiple copies is not allowed except
  244.     through execution of a licensing agreement.  Site license fees are
  245.     based upon estimated number of users.
  246.  
  247.     Note that with a site license, only one copy of the program will be
  248.     sent.  You will be responsible for distributing additional copies.
  249.  
  250.     Please call or write for more information.
  251.  
  252.     ALL PRICES AND DISCOUNTS ARE SUBJECT TO CHANGE WITHOUT NOTICE.
  253.     Discounts are not cumulative; they apply to single orders of like
  254.     products only. Unit prices are the same as for individual users.
  255.  
  256.     WARNING: YOU MAY NOT USE QEdit WITHIN YOUR ORGANIZATION WITHOUT A
  257.     PRIOR PURCHASE OR LICENSE ARRANGEMENT.
  258.  
  259.  
  260.                               CUSTOM VERSIONS
  261.  
  262.     We can produce custom versions of QEdit, for your private or
  263.     commercial use (i.e., to be distributed with your software). Give us
  264.     a call.
  265.  
  266.     Need a small, fast editor to distribute with your product?  Give us
  267.     a call.  We can probably work something out.
  268.  
  269.     Please direct all inquiries to:
  270.  
  271.     SemWare
  272.     4343 Shallowford Road, Suite C-3
  273.     Marietta, GA  30062-5003
  274.  
  275.     Phone: (404) 641-9002  9:00 - 5:00 EST
  276.  
  277.  
  278.  
  279.     Table of Contents
  280.     =========================================================================
  281.  
  282.     Acknowledgements ..............................................  ii
  283.     Introduction .................................................. iii
  284.     Features ......................................................  iv
  285.     System Requirements ...........................................   v
  286.     Installation ..................................................  vi
  287.  
  288.     Chapter 1  Users Guide for QEdit                                1-1
  289.         Quick Start ............................................... 1-2
  290.             Getting Started ....................................... 1-2
  291.             In the Editor ......................................... 1-2
  292.             Getting Out ........................................... 1-3
  293.         Menus ..................................................... 1-3
  294.         The Status Line ........................................... 1-4
  295.         Files ..................................................... 1-5
  296.             Creating New Files .................................... 1-5
  297.             Loading Existing Files ................................ 1-5
  298.             Multiple Files:  The Ring ............................. 1-6
  299.             Saving Files and Exiting  ............................. 1-8
  300.         Viewing and Getting Around in the Text .................... 1-9
  301.             Cursor Movement ....................................... 1-9
  302.                 Moving Through a File ............................. 1-9
  303.                 Moving Around on the Screen ....................... 1-12
  304.                 Moving by Lines and Characters .................... 1-13
  305.             Using Windows ......................................... 1-13
  306.                 Creating Windows .................................. 1-14
  307.                 Switching Windows ................................. 1-14
  308.                 Changing Window Size .............................. 1-14
  309.                 Closing Windows ................................... 1-15
  310.         Copying, Moving, Replacing, and Deleting text ............. 1-16
  311.             Block Commands ........................................ 1-16
  312.                 Marking and Unmarking a Block ..................... 1-16
  313.                 Manipulating Blocks Directly ...................... 1-18
  314.                 Manipulating Blocks Using Scrap Buffers ........... 1-19
  315.                 Manipulating Blocks Using Scratch Buffers ......... 1-21
  316.                 Examples of Block Commands ........................ 1-22
  317.             Non-Block Commands .................................... 1-25
  318.                 Adding Text ....................................... 1-25
  319.                 Copying Text ...................................... 1-26
  320.                 Moving Text ....................................... 1-27
  321.                 Deleting and Undeleting Text ...................... 1-28
  322.                 Replacing Text .................................... 1-29
  323.             The Kill Buffer - A Safety Net ........................ 1-31
  324.         Macros .................................................... 1-33
  325.             Creating Macros ....................................... 1-33
  326.  
  327.  
  328.  
  329.             Using Macros .......................................... 1-34
  330.             Saving and Reloading Macros ........................... 1-34
  331.             Example of a Macro .................................... 1-35
  332.         Printing .................................................. 1-35
  333.             Print Formatting ...................................... 1-36
  334.             Formfeeds ............................................. 1-36
  335.         The Shell and Dos Commands ................................ 1-37
  336.         Word Processing Commands .................................. 1-38
  337.         Modes ..................................................... 1-39
  338.  
  339.     Chapter 2  Customizing QEdit                                    2-1
  340.         Initiating the Configuration Program ...................... 2-2
  341.         The Configuration Menu .................................... 2-3
  342.         Advanced Options .......................................... 2-5
  343.         Colors/Screen Options ..................................... 2-7
  344.         General Options ........................................... 2-9
  345.         The Help Screen ........................................... 2-13
  346.         Keyboard Configuration .................................... 2-14
  347.             The Keyboard Definition File .......................... 2-14
  348.             Creating a Keyboard Definition File ................... 2-16
  349.         Printer Options ........................................... 2-17
  350.         Tab Settings .............................................. 2-18
  351.  
  352.     Chapter 3  QEdit Command Reference                              3-1
  353.  
  354.     Appendix A.  List of Commands                                   A-1
  355.         By Function ............................................... A-1
  356.         Alphabetically ............................................ A-6
  357.  
  358.     Appendix B.  List of Configurable Keys                          B-1
  359.         Function Keys ............................................. B-1
  360.         Special Purpose Keys ...................................... B-2
  361.         Control Keys .............................................. B-3
  362.         Alternate Keys ............................................ B-5
  363.         Enhanced Keyboard Keys .................................... B-6
  364.  
  365.     Appendix C.  Error Messages                                     C-1
  366.         QEdit Error Messages ...................................... C-1
  367.         QCONFIG Error Messages .................................... C-3
  368.  
  369.     Appendix D.  Commonly Used Macros                               D-1
  370.  
  371.     Appendix E.  The Author                                         E-1
  372.  
  373.     Index                                                           I-1
  374.  
  375.  
  376.  
  377.     Acknowledgements
  378.     =========================================================================
  379.  
  380.     Many years of work have gone into the development of this version of
  381.     QEdit.  And we had LOTS of help.  Special thanks go to:
  382.  
  383.     My wife, for her many valuable suggestions, for "proofing" this
  384.     manual, and for putting up with all the long hours (and many all
  385.     nighters) that I have spent working on QEdit.
  386.  
  387.     Gerhard Barth, who went above and beyond the call of duty to help us
  388.     track down a nasty bug in the very first version of QEdit.
  389.  
  390.     P.L. Olympia, who has gone out of his way and spent much time
  391.     promoting this program.
  392.  
  393.     Anthony M. Marcy, who developed the INLINER program, an assembler
  394.     which translates 8088 assembly language directly into Turbo Pascal
  395.     INLINE code.
  396.  
  397.     Karl Brendel, for his constant support and excellent testing.  Karl
  398.     is also the author of an excellent add-on product for QMODEM called
  399.     QFONEDIT.
  400.  
  401.     John Newlin, for his encouragement and support.  John is also the
  402.     author of SCOUT.  If you're looking for a powerful file or DOS
  403.     manager that's memory resident, then look no further.  SCOUT is
  404.     probably what you're looking for.
  405.  
  406.     Stuart Warren, for his insight, encouragement, and many valuable
  407.     programming suggestions.
  408.  
  409.     Steve Watkins, for all the many hours he spent testing and the many
  410.     "hard to find" bugs and quirks that he uncovered.
  411.  
  412.     All the folks at TurboPower software.  We're especially grateful for
  413.     TdebugPlus.  Using Turbo Pascal without the tools provided by the
  414.     TurboPower folks is just plain wasteful!
  415.  
  416.     To ALL registered users - THANK YOU - it is only through your
  417.     support that additional versions are made possible.
  418.  
  419.                                ii
  420.  
  421.  
  422.     Introduction
  423.     =========================================================================
  424.  
  425.     "You can never be too rich, too thin, or have too much RAM and Disk
  426.     storage."  Ancient American proverb, ca. 1980
  427.  
  428.     This manual describes the use and operation of QEdit, a full-screen
  429.     text editor for the IBM PC and compatible computers.  The manual
  430.     includes installation instructions, a user's guide, and a reference
  431.     section which explains all of QEdit's commands.
  432.  
  433.     QEdit is a text editor as opposed to a word processor.  This means
  434.     that most of its features are geared toward creating and maintaining
  435.     program source code and other text files.  However, QEdit can also
  436.     be used like a word processor to write documents or letters since it
  437.     includes word-wrapping and paragraph reformatting capabilities.
  438.  
  439.  
  440.     QEdit was developed with these goals in mind:
  441.  
  442.     ■ FAST OPERATION - More than anything else, QEdit was designed to
  443.       operate quickly, especially in these areas:
  444.  
  445.         - Initially loading a file for editing.
  446.         - Displaying/Updating the screen.
  447.         - Moving through the editing window.
  448.         - Searching for text.
  449.         - Saving a file back to disk.
  450.  
  451.  
  452.     ■ EASE OF USE - This version of QEdit includes:
  453.  
  454.         - Optional "Pop-Down" menus.
  455.         - Customizable Help Screen.
  456.         - Complete execution from a single file (Q.EXE).
  457.         - Pop-up file directory and picker.
  458.  
  459.  
  460.     ■ COMPACT PROGRAM SIZE - Every effort was made to keep the program
  461.       size as compact as possible.  Even though memory is getting
  462.       cheaper all the time, we didn't want QEdit to require any more
  463.       memory than absolutely necessary.
  464.  
  465.                                iii
  466.  
  467.  
  468.     Features
  469.     =========================================================================
  470.  
  471.     These are just some of the many features you will enjoy while using
  472.     QEdit:
  473.  
  474.     ■ It is very fast!
  475.  
  476.     ■ It is customizable.  QEdit can be easily configured the way you
  477.       like it.  This includes the meaning of ALL special keys on the
  478.       keyboard (Alt, Ctrl, and function keys; <Home>, <PgUp>, etc.),
  479.       colors, screen appearance, and many other options.
  480.  
  481.     ■ It utilizes all available memory.  With QEdit you can edit files
  482.       as large as your computer's memory will allow.
  483.  
  484.     ■ It allows true multi-file editing.  The number of files you can
  485.       edit is limited only by available memory.
  486.  
  487.     ■ It enables you to view files through up to eight "windows".  You
  488.       can have multiple views of the same file or view a different file
  489.       in each window.
  490.  
  491.     ■ It provides up to 99 scratch buffers for cut-and-paste or template
  492.       operations.
  493.  
  494.     ■ It allows you to exit to DOS (or a DOS shell) temporarily and use
  495.       DOS commands from within the editor.
  496.  
  497.     ■ It is easy to use.  You can use the optional "Pop-Down" menus to
  498.       access QEdit's commands, and there is a Help Screen which you can
  499.       customize for your own needs.
  500.  
  501.     ■ It supports Character, Line, and Column Blocks.
  502.  
  503.     ■ It allows you to create macros which will execute a series of
  504.       commands and keystrokes by pressing a single key.
  505.  
  506.     ■ It provides wordwrap and paragraph reformat capabilities.
  507.  
  508.     ■ It saves deleted words, lines, and Blocks in a deletion buffer for
  509.       later recall.
  510.  
  511.     ■ It provides "C mode", which utilizes automatic indentation for C
  512.       language programming.
  513.  
  514.     ■ It locates matching braces and parentheses, a useful feature for
  515.       programming.
  516.  
  517.     ■ It will load multiple files from the DOS command line, with or
  518.       without wildcard characters.
  519.  
  520.     ■ It allows you to specify up to six default file extensions for use
  521.       when loading files and determining tab settings.
  522.  
  523.                                iv
  524.  
  525.  
  526.     ■ It allows you to execute command line compilers from within QEdit,
  527.       using its macro capability.
  528.  
  529.     ■ It provides line drawing to create diagrams and tables.
  530.  
  531.     ■ It supports enhanced (101 key) keyboards.
  532.  
  533.     ■ It supports up to 200-column and 100-line screens.
  534.  
  535.     ■ It supports EGA 43-line mode and VGA 50-line mode.
  536.  
  537.     ■ It is compact.  Even with all these features, QEdit requires less
  538.       than 50k of disk space.
  539.  
  540.  
  541.  
  542.     System Requirements
  543.     =========================================================================
  544.  
  545.     QEdit will run on the IBM PS/2, PC/AT, PC/XT, PC, PC/Jr, and on IBM
  546.     compatible computers including the Compaq, NCR, Tandy, and WYSE
  547.     PC's.  MINIMUM requirements are:
  548.  
  549.     ■ 128 KB of memory (although QEdit can utilize up to 640 KB if it is
  550.       available).
  551.  
  552.     ■ PC-DOS 2.0 or greater or MS-DOS 2.0 or greater.
  553.  
  554.     ■ One diskette drive.
  555.  
  556.     ■ Either a color or a monochrome monitor with 80-column display.
  557.  
  558.     ■ 60 KB of disk space.
  559.  
  560.     ■ Q.EXE, the editor program itself.  No other files are necessary
  561.       for operating QEdit.
  562.  
  563.                                v
  564.  
  565.  
  566.     Installation
  567.     =========================================================================
  568.  
  569.     Before installing QEdit, you should review the contents of the
  570.     READ.ME file on your QEdit distribution diskette.  This file
  571.     contains important information (usage information, new features,
  572.     changes, etc.) that became available after this manual was printed.
  573.     You should carefully review the READ.ME file before using QEdit.
  574.  
  575.     The READ.ME file also contains a complete list of the files included
  576.     on the distribution diskette.  A partial list is included here:
  577.  
  578.     Q.EXE           QEdit.  No other files are necessary for proper
  579.                     operation of QEdit.
  580.  
  581.     QCONFIG.EXE     The QEdit configuration program.  This program
  582.                     allows you to customize QEdit.
  583.  
  584.     QCONFIG.DAT     The default QEdit Keyboard Definition file. Used by
  585.                     QCONFIG.EXE.
  586.  
  587.     QHELP.TXT       The default QEdit Help text.  Used by QCONFIG.EXE.
  588.  
  589.  
  590.     QEdit is simple to install.  But first, be sure to make a backup
  591.     copy of the distribution diskette.
  592.  
  593.     Once you have made your backup copy, simply copy Q.EXE to the disk
  594.     and/or subdirectory where you would like to use it.  If you are
  595.     using a hard disk, then you probably want to put it somewhere that
  596.     is accessible via the "path".  For example, on our system, we keep
  597.     many of our executable programs in a subdirectory called TOOLS.
  598.  
  599.     ┌─────────────────────────────────┐
  600.     │QEdit Tip:                       │
  601.     │ Please note that one of the     │
  602.     │ MAJOR features of QEdit is      │
  603.     │ configurability.  You can       │
  604.     │ customize the colors, the keys, │
  605.     │ the on-screen appearance of the │
  606.     │ editor, and many other          │
  607.     │ functions.                      │
  608.     │                                 │
  609.     │ By spending just a small amount │
  610.     │ of time reviewing Chapter 2 on  │
  611.     │ configuration, you can benefit  │
  612.     │ greatly through customizing the │
  613.     │ editor to your personal         │
  614.     │ preferences.                    │
  615.     └─────────────────────────────────┘
  616.  
  617.     If you will be customizing QEdit (Refer to Chapter 2 for complete
  618.     information on customizing QEdit), then you may wish to create a
  619.     special directory and copy the files Q.EXE, QCONFIG.EXE,
  620.     QCONFIG.DAT, and QHELP.TXT to that directory.
  621.  
  622.                                vi
  623.  
  624.  
  625.     Chapter 1. Users Guide For QEdit
  626.     =========================================================================
  627.  
  628.     Quick Start
  629.     ─────────────────────────────────────────────────────────────────────────
  630.  
  631.     With QEdit you can edit any text file with a few simple commands.
  632.     The next three sections briefly describe the quickest way possible
  633.     to load, edit, and save a file.
  634.  
  635.  
  636.     Getting Started
  637.  
  638.     Using QEdit is simple and straightforward.
  639.  
  640.     To initiate QEdit, type "Q <Enter>".  The Editor will respond with
  641.     a prompt for the name of the file to be edited.
  642.  
  643.     ┌─────────────────────────────────────────────────────────────────┐
  644.     │  File(s) to edit: <Esc = abort>                                 │
  645.     │                                                                 │
  646.     └─────────────────────────────────────────────────────────────────┘
  647.  
  648.     Enter the filename.  The filename may include full path designation.
  649.  
  650.     ┌─────────────────────────────────┐
  651.     │QEdit Tip:                       │
  652.     │  At any "File to edit" prompt,  │
  653.     │  you may use wildcard characters│
  654.     │  (* or ?) to obtain a list of   │
  655.     │  matching files in the          │
  656.     │  directory.                     │
  657.     └─────────────────────────────────┘
  658.  
  659.     You may optionally include the filename on the DOS command line in
  660.     order to bypass this prompt.  For example, from the DOS command
  661.     line, type: "Q filename <Enter>"
  662.  
  663.  
  664.     In the Editor
  665.  
  666.     Once you are in QEdit, the cursor movement keys (Left, Right, Up,
  667.     Down, Home, End, ...) allow you to move around in the text.
  668.  
  669.     To obtain a help screen, simply press <F1>.  Pressing <F1> again
  670.     returns you to the text.
  671.  
  672.     To obtain a menu of QEdit commands, press <Esc>.  You may then use
  673.     the cursor movement keys to position the cursor bar over the desired
  674.     command.  Pressing <Enter> will execute the command.
  675.  
  676.                                1-2
  677.  
  678.     ┌─────────────────────────────────┐
  679.     │ QEdit Tip:                      │
  680.     │   Pressing <Esc> will abort     │
  681.     │   any editor prompt.            │
  682.     └─────────────────────────────────┘
  683.  
  684.  
  685.     Getting Out
  686.  
  687.     The easiest way to get out of QEdit and save all the work you have
  688.     done is to enter <Alt F> <G>.
  689.  
  690.  
  691.     Menus
  692.     ─────────────────────────────────────────────────────────────────────────
  693.  
  694.     QEdit provides an easy-to-use "Pop-Down" style menu system.  The
  695.     menu system is very helpful while learning to use the editor.  It is
  696.     also handy for executing seldom used commands.
  697.  
  698.     To access the menus and execute a command:
  699.  
  700.     1.  Press <Esc>.  The main menu will be displayed at the top of
  701.         the screen.  The main menu consists of a list of sub-menu items.
  702.  
  703.     2.  Select a sub-menu item.  You may do this by moving the cursor
  704.         bar to the desired item and pressing <Enter> or by typing the
  705.         capital letter of the desired item.
  706.  
  707.     3.  Execute a command.  This is done in the same manner as selecting
  708.         the sub-menu items.
  709.  
  710.     Here is an example of the "Pop-Down" style menu system.  This User
  711.     is about to execute the "Copy block" command.
  712.  
  713.     (illustration not available in disk manual)
  714.  
  715.     You can execute many QEdit commands using the menus.  As you become
  716.     more familiar with the editor, you may wish to use the <Ctrl>,
  717.     <Alt>, and function keys, instead of the menus, to execute commands
  718.     more quickly.  A cross reference of all QEdit commands can be found
  719.     in Appendix A.
  720.  
  721.                                1-3
  722.  
  723.  
  724.     The Status Line
  725.     ─────────────────────────────────────────────────────────────────────────
  726.  
  727.     At the top of the editing screen is the Status Line.  The Status
  728.     Line constantly displays information regarding the file you are
  729.     currently editing.
  730.  
  731.     The Status Line is shown below with a description of the information
  732.     displayed.
  733.  
  734.     ┌──────────────────────────────────────────────────────────────────────┐
  735.     │L 15   C 15   IAW R B  411K     *c:\qedit\qedit.doc                   │
  736.     └──┬──────┬────┬┬┬─┬─┬───┬───────┬───────┬─────────────────────────────┘
  737.        │      │    │││ │ │   │       │       │
  738.        │      │    │││ │ │   │       │       └──── The path and name of the
  739.        │      │    │││ │ │   │       │             file you are editing
  740.        │      │    │││ │ │   │       │
  741.        │      │    │││ │ │   │       └──── *) Indicates file has been changed
  742.        │      │    │││ │ │   │
  743.        │      │    │││ │ │   └──── Amount of available memory
  744.        │      │    │││ │ │
  745.        │      │    │││ │ └──── B) Indicates Box Drawing mode is ON
  746.        │      │    │││ │
  747.        │      │    │││ └──── R) Indicates macro recording is ON
  748.        │      │    │││
  749.        │      │    ││└──── W) Indicates WordWrap mode is ON
  750.        │      │    ││
  751.        │      │    │└──── A) Indicates AutoIndent mode is ON
  752.        │      │    │
  753.        │      │    └──── I) Indicates Insert mode is ON
  754.        │      │
  755.        │      └──── The current cursor column number
  756.        │
  757.        └──── The current cursor line number
  758.  
  759.  
  760.     For more information on Insert, AutoIndent, WordWrap, and Box
  761.     Drawing, refer to the "Modes" section in this chapter. For more
  762.     information on macro recording, refer to the "Macros" section in
  763.     this chapter.
  764.  
  765.     ┌─────────────────────────────────┐
  766.     │ QEdit Tip:                      │
  767.     │   The Status Line may be config-│
  768.     │   ured to appear at the bottom  │
  769.     │   of the screen.  Refer to the  │
  770.     │   "Colors/Screen Options"       │
  771.     │   section of Chapter 2 for more │
  772.     │   information.                  │
  773.     └─────────────────────────────────┘
  774.  
  775.                                1-4
  776.  
  777.  
  778.     Files
  779.     ─────────────────────────────────────────────────────────────────────────
  780.  
  781.     Creating New Files
  782.  
  783.     There are three different ways to create new files, ready for editing.
  784.  
  785.     1. From the DOS command line, enter <Q> followed by one or more new
  786.        filenames.  Each filename must be separated by a space. For
  787.        example, typing:
  788.  
  789.                    "Q file1 b:file2 \dir1\file3 <Enter>"
  790.  
  791.        will create "file1" in the current directory, "file2" on disk
  792.        drive B, and "file3" in the directory "dir1".
  793.  
  794.     ┌─────────────────────────────────┐
  795.     │ QEdit Tip:                      │
  796.     │   When specifying file names    │
  797.     │   to QEdit, you may use full    │
  798.     │   path designations if desired. │
  799.     └─────────────────────────────────┘
  800.  
  801.     2. From the DOS command line, type "Q <Enter>".  QEdit will respond
  802.        with the prompt:
  803.  
  804.        ┌─────────────────────────────────────────────────────────────────┐
  805.        │  File(s) to edit: <Esc = abort>                                 │
  806.        │                                                                 │
  807.        └─────────────────────────────────────────────────────────────────┘
  808.  
  809.        Enter one or more new filenames, each separated by a space.
  810.  
  811.     3. From within the editor, enter the EditFile <Alt E> command. The
  812.        above prompt will appear.  Again, you may enter one or more new
  813.        filenames, each separated by a space.
  814.  
  815.  
  816.     Loading Existing Files
  817.  
  818.     Loading existing files works exactly like creating new files (in the
  819.     previous section) with two exceptions:
  820.  
  821.     ■ The filename(s) specified must exist on disk.
  822.  
  823.     ■ The filename(s) may contain wildcard characters (*, ?).
  824.  
  825.     QEdit can be configured to respond to wildcarded filename entries in
  826.     one of two ways:
  827.  
  828.     1. Load all matching files into the editor.
  829.  
  830.                                1-5
  831.  
  832.     2. Show all the matching filenames in a "pick" listing. You can then
  833.        use the cursor keys to find the file you want and press <Enter>
  834.        to load it into the editor.
  835.  
  836.     QEdit can also be configured to use default file extensions, such as
  837.     "doc" and "pas" when entering filenames.  For more information on
  838.     configuring these options, refer to the "General Options" section of
  839.     Chapter 2.
  840.  
  841.  
  842.     Multiple Files: The Ring
  843.  
  844.     QEdit is a true multi-file editor.  It allows as many files as will
  845.     fit into memory to be loaded at the same time.  All of these files
  846.     can then be edited by simply switching back and forth between them
  847.     without having to save and load each file individually. Switching
  848.     between files is accomplished very quickly and easily.
  849.  
  850.     A simple explanation of how QEdit handles multiple files will help
  851.     you in manipulating and editing multiple files.
  852.  
  853.     QEdit maintains all loaded files in a "ring".  As we describe each
  854.     of the commands used to manipulate the files in the ring, refer to
  855.     the illustration below.
  856.  
  857.     (illustration not available in disk manual)
  858.  
  859.     In the ring we see that six files have been loaded into the editor.
  860.     You can, of course, load many more files - as many as your
  861.     computer's memory will allow.
  862.  
  863.                                1-6
  864.  
  865.     Assume the file currently being edited is file "B".  You may then
  866.     move from one file to another in any of the following ways:
  867.  
  868.     ■ Enter the NextFile <Alt N> command.
  869.       You will now be editing the next file in the ring, file "C".
  870.  
  871.     ■ Enter the PrevFile <Ctrl KP> command.
  872.       You will now be editing the previous file in the ring, file "A".
  873.  
  874.     ■ Enter the EditFile <Alt E> command.
  875.       The editor will prompt for a filename.  You may enter the name of
  876.       any file in the ring.  The editor will make the entered file the
  877.       current one for editing.
  878.  
  879.     You may, at any time, add files to the ring or discard files from
  880.     the ring.  If you add a new file to the ring using the EditFile
  881.     command, it will become the current file and the old current file
  882.     will become the previous file.  If you delete a file from the ring
  883.     the previous file will become the current file.
  884.  
  885.     ┌─────────────────────────────────┐
  886.     │ QEdit Tip:                      │
  887.     │   When loading files, be aware  │
  888.     │   that QEdit will not load two  │
  889.     │   copies of the same file.  If  │
  890.     │   you issue the EditFile command│
  891.     │   for a file already loaded,    │
  892.     │   that file will become the     │
  893.     │   new current file.             │
  894.     └─────────────────────────────────┘
  895.  
  896.                                1-7
  897.  
  898.  
  899.     Saving Files and Exiting
  900.  
  901.     QEdit provides several different ways to save files, discard files,
  902.     and exit the editor.  A set of five basic commands provides assorted
  903.     combinations of saving, discarding, and exiting in order to suit
  904.     individual preferences.
  905.  
  906.     We recommend selecting one or two methods with which you feel most
  907.     comfortable and using them consistently.
  908.  
  909.     The table below summarizes these commands and their effects.
  910.  
  911. ┌──────────────────────────────────────────────────────────────────────────────┐
  912. │Command for Single        Command for Multiple                                │
  913. │File or Current File      Files                                               │
  914. │--------------------      --------------------                                │
  915. │Exit      <Ctrl KD>       GExit     <Alt X>                X         X    X(a)│
  916. │                                                                              │
  917. │File      <Ctrl KX>       GFile     <Alt F><G>        X              X    X(a)│
  918. │                                                                              │
  919. │PQuit     <Ctrl KQ>       GPQuit    <Alt Q><Q>                  X    X    X(a)│
  920. │                                                                              │
  921. │Quit (b)                                                             X    X   │
  922. │                                                                              │
  923. │SaveFile  <Ctrl KS>       GSave     <Alt Y>           X                       │
  924. │                                                                              │
  925. │                                                      │    │    │    │    │   │
  926. │         Edited File(s) are Saved Unconditionally  ───┘    │    │    │    │   │
  927. │                                                           │    │    │    │   │
  928. │             User Prompted to Save Edited Files (Y/N)  ────┘    │    │    │   │
  929. │                                                                │    │    │   │
  930. │                User Warned That File Changes May Be Lost  ─────┘    │    │   │
  931. │                                                                     │    │   │
  932. │                            File(s) are Discarded From Editor  ──────┘    │   │
  933. │                                                                          │   │
  934. │                                         The Editor is Terminated  ───────┘   │
  935. │                                                                              │
  936. │    (a) The Exit, File, and PQuit commands can be configured to terminate     │
  937. │        or not terminate the editor.  Refer to the "General Options" section  │
  938. │        of Chapter 2 for more information.                                    │
  939. │                                                                              │
  940. │    (b) USE WITH CAUTION!                                                     │
  941. └──────────────────────────────────────────────────────────────────────────────┘
  942.  
  943.                                1-8
  944.  
  945.     Viewing and Getting Around in the Text
  946.     ─────────────────────────────────────────────────────────────────────────
  947.  
  948.     QEdit is quite versatile in allowing you to move around in the text.
  949.     With simple keystrokes you can either move a few characters or lines
  950.     at a time or move from one end of the file to another.  You can go
  951.     to specific lines in the file or go to each occurrence of a
  952.     particular string of characters.  And with QEdit's windows, you can
  953.     view up to eight files at a time or have multiple views of the same
  954.     file.
  955.  
  956.     As you will see, there are quite a few commands in QEdit for moving
  957.     around in your text.  If you are not already familiar with these
  958.     types of commands, try them out.  You will probably find some new
  959.     commands that will be useful for your applications of QEdit.
  960.  
  961.  
  962.     Cursor Movement
  963.     ─────────────────────────────────────────────────────────────────────────
  964.  
  965.     Moving Through a File
  966.  
  967.     QEdit provides several commands which enable you to move about in a
  968.     file.
  969.  
  970.     ■ BegFile <Ctrl PgUp> and EndFile <Ctrl PgDn>
  971.       As their names imply, these commands move the cursor to the
  972.       beginning or end of the current file.  BegFile positions the
  973.       cursor at column one on the first line of the file.  EndFile
  974.       positions the cursor after the last non-blank character on the
  975.       last line of the file.
  976.  
  977.     ■ PageUp <PgUp> and PageDown <PgDn>
  978.       PageUp scrolls the text toward the top of the file, one page-full,
  979.       less one line, at a time.  PageDown scrolls the text toward the
  980.       end of the file, one page-full, less one line, at a time.
  981.  
  982.     ■ HalfPgUp and HalfPgDn
  983.       These commands work exactly like the PageUp and PageDown commands,
  984.       except that they scroll only one-half page at a time.
  985.  
  986.     ┌─────────────────────────────────┐
  987.     │ QEdit Tip:                      │
  988.     │   All QEdit commands, including │
  989.     │   those without default key     │
  990.     │   assignments, can be assigned  │
  991.     │   as the user desires, to       │
  992.     │   almost any key.  Refer to     │
  993.     │   the "Keyboard Configuration"  │
  994.     │   section of Chapter 2 for more │
  995.     │   information.                  │
  996.     └─────────────────────────────────┘
  997.  
  998.                                1-9
  999.  
  1000.  
  1001.     ■ ScrollUp <Ctrl W> and LineUp
  1002.       These commands scroll the text one line at a time toward the
  1003.       beginning of the file.
  1004.  
  1005.       The ScrollUp command will cause the cursor to remain on the same
  1006.       line of text until it reaches the bottom of the screen, while the
  1007.       LineUp command will cause the cursor to remain stationary on the
  1008.       screen.
  1009.  
  1010.     ■ ScrollDown <Ctrl Z> and LineDown
  1011.       These commands scroll the text one line at a time toward the end
  1012.       of the file.
  1013.  
  1014.       The ScrollDown command will cause the cursor to remain on the same
  1015.       line of text until it reaches the top of the screen, while the
  1016.       LineDown command will cause the cursor to remain stationary on the
  1017.       screen.
  1018.  
  1019.     ■ GotoLine <Ctrl J>
  1020.       Upon entering the GotoLine command, QEdit will prompt with:
  1021.  
  1022.       ┌──────────────────────────┐
  1023.       │line number: <Esc = abort>│
  1024.       │                          │
  1025.       └──────────────────────────┘
  1026.  
  1027.       By typing a line number and <Enter>, QEdit will "jump" the cursor
  1028.       to the specified line number.  An easy way to move about quickly
  1029.       in your text is to keep track of critical positions by noting
  1030.       their line number, which is displayed on the Status Line, and then
  1031.       using this command to "jump" to those positions.
  1032.  
  1033.  
  1034.     ■ GotoBlockBeg <Ctrl QB> and GotoBlockEnd <Ctrl QK>
  1035.       These commands move the cursor to the beginning or to the end of
  1036.       the currently marked Block.  If the marked Block is in another
  1037.       file, QEdit will make that file the current file and then move you
  1038.       to the beginning or end of the Block.  For more information on
  1039.       using marked Blocks, refer to the "Block Commands" section in this
  1040.       chapter.
  1041.  
  1042.     ■ PrevPosition <Ctrl QP>
  1043.       This command can come in very handy.  It moves you to the cursor's
  1044.       previous position.  Although it would not be of much use if you
  1045.       had only moved a character or two, it can be useful for larger
  1046.       jumps of the cursor.
  1047.  
  1048.       For example, perhaps you are in the middle of a file and want to
  1049.       check something at the very beginning of the file.  To get to the
  1050.       beginning, you would simply enter BegFile <Ctrl PageUp>.  After
  1051.       you look at the beginning, you want to get back to where you were
  1052.       previously.  You could use PageDown, but that could be tedious,
  1053.       especially if your file is large.  The easiest way would be to
  1054.       enter PrevPosition, and with a single keystroke, you are
  1055.       immediately back where you started.  Note: PrevPosition can only
  1056.       take you back to the cursor's immediately previous position.
  1057.  
  1058.                                1-10
  1059.  
  1060.       If there are intervening keystrokes that move the cursor,
  1061.       PrevPosition will move you back to the most recent location of the
  1062.       cursor.
  1063.  
  1064.     ■ Find <Ctrl QF> and RepeatFind <Ctrl L>
  1065.       These commands will search for a specific string of characters in
  1066.       the file.  Upon entering the Find command, QEdit will prompt for
  1067.       the string of characters for which to search.
  1068.  
  1069.       ┌─────────────────────────────────────────────────────────────────┐
  1070.       │Search for: <Esc = Abort>                                        │
  1071.       │                                                                 │
  1072.       └─────────────────────────────────────────────────────────────────┘
  1073.  
  1074.       Enter the desired string of characters and press <Enter>.
  1075.  
  1076.       QEdit will then prompt for the search options to use.
  1077.  
  1078.       ┌──────────────────────────────────────────────────────┐
  1079.       │Options [IWB] (Ignore, Words, Backward) <Esc = Abort> │
  1080.       │I                                                     │
  1081.       └──────────────────────────────────────────────────────┘
  1082.  
  1083.       Enter the letter(s) corresponding to the option(s) you want and
  1084.       press <Enter>.  The available options are:
  1085.  
  1086.         [I] = Ignore the case (capital or lowercase) of the search
  1087.               string.  For example, "Hello" would match "hello" if this
  1088.               option is chosen.  This option is set ON by default.
  1089.  
  1090.         [W] = Search for whole words only.  For example, when this
  1091.               option is chosen, the word "sent" will match only the
  1092.               actual word "sent".  Otherwise, any other words that
  1093.               contain the string (such as "sentence" or "absent") would
  1094.               also match.
  1095.  
  1096.         [B] = Search backward from the current cursor position.  When
  1097.               you choose "B", QEdit will search backward from the cursor
  1098.               position toward the beginning of the file.  Otherwise, it
  1099.               will search from the cursor position toward the end of the
  1100.               file.
  1101.  
  1102.       Once the Find command is executed the cursor will be placed at the
  1103.       first occurrence of the search string found in the text.  To
  1104.       locate subsequent occurrences of the search string, simply enter
  1105.       the RepeatFind command.
  1106.  
  1107.       If you want to search for a string and replace it with another
  1108.       string, refer to the "Replacing Text" section in this chapter.
  1109.  
  1110.     ■ Match <Alt F3>
  1111.       This is a specialized search command.  It acts only on the
  1112.       characters ( ), { }, and [ ].  With the cursor placed on one of
  1113.       these characters, enter the Match command.  QEdit will locate the
  1114.       logical matching character of the pair.  This command can be
  1115.       useful for programming in languages where complicated expressions
  1116.       are grouped using these characters.
  1117.  
  1118.                                1-11
  1119.  
  1120.  
  1121.     Moving Around on the Screen
  1122.  
  1123.     These commands affect the cursor position within the current screen
  1124.     of displayed text.
  1125.  
  1126.     ■ BegScreen <Ctrl Home> and EndScreen <Ctrl End>
  1127.       These commands move you to the first or last line of the screen
  1128.       (or current window if you have windows open).  The cursor's column
  1129.       position does not change.
  1130.  
  1131.     ■ BegLine <Home> and EndLine <End>
  1132.       You are probably already familiar with these commands.  BegLine
  1133.       moves the cursor to the beginning, or column one, of the current
  1134.       cursor line. EndLine moves the cursor to the last non-blank
  1135.       character of the current cursor line.
  1136.  
  1137.     ■ ScreenLeft <Alt F5> and ScreenRight <Alt F6>
  1138.       These commands scroll the entire text to the left or right one
  1139.       column at a time.  You can change the number of columns which are
  1140.       shifted each time using the QEdit configuration program.  Refer to
  1141.       the "Colors/Screen Options" section of Chapter 2 for more
  1142.       information.
  1143.  
  1144.     ■ WordLeft <Ctrl Cursor Left> and WordRight <Ctrl Cursor Right>
  1145.       These commands move the cursor to the first character of the
  1146.       previous or following word in the text.
  1147.  
  1148.     ■ MakeCtrofScreen <Shift F5>, MakeTopofScreen <F5>, and MakeBotofScreen
  1149.       These three commands change the position of the cursor line on the
  1150.       screen (or window, if you have windows open). They can be useful
  1151.       if you prefer to work at the bottom or top of the screen or if you
  1152.       want to keep the text surrounding your cursor line in view.
  1153.  
  1154.       The MakeCtrofScreen command scrolls the text on the screen (either
  1155.       up or down) until the cursor line is the center line of the
  1156.       screen.
  1157.  
  1158.       The MakeTopofScreen command scrolls the text upward until the
  1159.       cursor line is the top line of the screen.
  1160.  
  1161.       The MakeBotofScreen command scrolls the text downward until the
  1162.       cursor line is the last line of the screen.
  1163.  
  1164.                                1-12
  1165.  
  1166.  
  1167.     Moving By Lines and Characters
  1168.  
  1169.     These commands enable you to move in short increments through the
  1170.     text.
  1171.  
  1172.     ■ CursorLeft <Cursor Left> and CursorRight <Cursor Right>
  1173.       These commands move the cursor one column to the right or left on
  1174.       the cursor line.
  1175.  
  1176.       When you use CursorLeft, the cursor will stop when it reaches the
  1177.       left edge of the screen, unless the text has been scrolled to the
  1178.       left.  In that case it scrolls the text to the right one column at
  1179.       a time until it reaches column one.
  1180.  
  1181.       When you use CursorRight and the cursor reaches the right edge of
  1182.       the screen, it will begin to scroll the text to the left.  It will
  1183.       stop scrolling when it reaches the maximum line length.
  1184.  
  1185.     ■ CursorUp <Cursor Up> and CursorDown <Cursor Down>
  1186.       These commands move the cursor up or down in the file one line at
  1187.       a time.  The cursor's column position does not change.
  1188.  
  1189.  
  1190.     Using Windows
  1191.     ─────────────────────────────────────────────────────────────────────────
  1192.  
  1193.     QEdit provides the ability to view different areas of files (either
  1194.     multiple files or the same file) at the same time, through the use
  1195.     of windows.  A window is a portion of the screen that allows you to
  1196.     view text.  You can divide your screen into as many as eight
  1197.     horizontal windows.  You can then view as many as eight different
  1198.     files through these windows or have multiple views of a single file.
  1199.     This capability can be quite helpful for comparing text, copying
  1200.     text, and moving text.
  1201.  
  1202.     An example of a screen split into three windows is shown below.
  1203.  
  1204.     (illustration not available in disk manual)
  1205.  
  1206.                                1-13
  1207.  
  1208.  
  1209.     Creating Windows
  1210.  
  1211.     To create a window, use the HorizontalWindow <Ctrl OH> command. The
  1212.     screen will be split into two halves, or windows, each window having
  1213.     its own Status Line.  The cursor will reside in the newly created
  1214.     window, making it the current window.
  1215.  
  1216.     If only one file is being edited, the newly created window will
  1217.     simply be an additional view of the same file.  QEdit will not load
  1218.     more than one copy of the same file.
  1219.  
  1220.     If multiple files are being edited, the newly created window will be
  1221.     a view of the next file in the ring.  (Refer to the "Multiple Files"
  1222.     section in this chapter.)  If desired, you can configure QEdit to
  1223.     prompt for the name of the file to be viewed in the new window
  1224.     instead of the editor automatically selecting the next file in the
  1225.     ring.  Refer to the "General Options" section of Chapter 2 for more
  1226.     information.
  1227.  
  1228.     Once the screen has been split into windows, entering the
  1229.     HorizontalWindow command again will affect the current window. All
  1230.     other windows will remain unchanged.
  1231.  
  1232.  
  1233.     Switching Windows
  1234.  
  1235.     When multiple windows are opened, editing will only take place in
  1236.     the current window (the window containing the cursor).  For editing
  1237.     text in other windows, two commands are provided to switch from one
  1238.     window to another.
  1239.  
  1240.     ■ The PrevWindow <Ctrl OP> command will move the cursor to the
  1241.       window above the current window.  If the current window is at the
  1242.       top of the screen, the cursor will move to the last window on the
  1243.       screen.
  1244.  
  1245.     ■ The NextWindow <Ctrl ON> command will move the cursor to the
  1246.       window below the current window.  If the current window is at the
  1247.       bottom of the screen, the cursor will move to the first window on
  1248.       the screen.
  1249.  
  1250.  
  1251.     Changing Window Size
  1252.  
  1253.     You can change the size of any of the windows on the screen with the
  1254.     commands below.
  1255.  
  1256.     ■ The GrowWindow <Ctrl OG> command allows you to increase the size
  1257.       of the current window.  Upon entering this command, QEdit will
  1258.       prompt you to increase the size of the window by using the cursor
  1259.       up and cursor down keys.  The cursor up key will increase the size
  1260.       of the current window one line at a time toward the top of the
  1261.       screen.  The cursor down key will increase the size of the current
  1262.       window one line at a time toward the bottom of the screen.
  1263.  
  1264.                                1-14
  1265.  
  1266.     ■ The ShrinkWindow <Ctrl OS> command allows you to decrease the size
  1267.       of the current window.   A window can be as small as 3 lines,
  1268.       including its Status Line.  Upon entering this command, QEdit will
  1269.       prompt you to decrease the size of the window by using the cursor
  1270.       up and cursor down keys.  The cursor up key will decrease the size
  1271.       of the current window one line at a time by moving the bottom of
  1272.       the window toward the top of the screen.  The cursor down key will
  1273.       decrease the size of the current window one line at a time by
  1274.       moving the top of the window toward the bottom of the screen.
  1275.  
  1276.     ┌─────────────────────────────────┐
  1277.     │ QEdit Tip:                      │
  1278.     │   The GrowWindow and Shrink-    │
  1279.     │   Window commands may be entered│
  1280.     │   successively, without pressing│
  1281.     │   <Esc> in between.             │
  1282.     └─────────────────────────────────┘
  1283.  
  1284.  
  1285.     ■ The ZoomWindow <Ctrl OZ> command will cause the current window to
  1286.       fill the entire screen, as all other windows disappear.  To
  1287.       restore the screen with all windows, simply press <Ctrl OZ> again.
  1288.       Be careful not to confuse this command with the OneWindow command
  1289.       (see below).  OneWindow fills the screen with the current window
  1290.       (like ZoomWindow does), but it also closes all windows except the
  1291.       current one.  ZoomWindow leaves the other windows intact, even
  1292.       though they are hidden from view.
  1293.  
  1294.  
  1295.     Closing Windows
  1296.  
  1297.     There are two commands to close windows.
  1298.  
  1299.     ■ The CloseWindow <Ctrl OC> command closes the current window.  The
  1300.       current window will disappear and the cursor will be placed in the
  1301.       window above the closed window, making it the new current window.
  1302.       When the closed window is at the top of the screen, the window
  1303.       below the closed window will become the new current window.
  1304.  
  1305.     ■ The OneWindow <Ctrl OO> command closes all windows except the
  1306.       current window.  The current window will fill the entire screen.
  1307.  
  1308.     Note that closing a window does not discard files from the editor.
  1309.  
  1310.                                1-15
  1311.  
  1312.  
  1313.     Copying, Moving, Replacing, and Deleting Text
  1314.     ─────────────────────────────────────────────────────────────────────────
  1315.  
  1316.  
  1317.     Block Commands
  1318.     ─────────────────────────────────────────────────────────────────────────
  1319.  
  1320.     In this section, we will see how to mark and manipulate Blocks.  A
  1321.     Block is some portion of the text file which has been specifically
  1322.     delineated using QEdit's Block marking commands.  We will see how to
  1323.     manipulate Blocks both directly and through the use of intermediate
  1324.     storage areas known as buffers.
  1325.  
  1326.     QEdit contains a rich set of Block commands.  There are commands to
  1327.     mark Blocks by lines, columns, and characters.  There are commands
  1328.     to copy, move, shift, and delete Blocks.  These commands are very
  1329.     useful for transferring text from one file to another. There are
  1330.     also cut-and-paste commands, as well as commands to move Blocks to
  1331.     and from named Scratch Buffers.
  1332.  
  1333.  
  1334.     Marking and Unmarking a Block
  1335.  
  1336.     Before you can manipulate a Block, you must first "mark" or outline
  1337.     a Block.  There are four ways of marking a Block in QEdit.  The one
  1338.     you choose will depend on the editing situation and what you find
  1339.     most comfortable to use.
  1340.  
  1341.     ■ MarkLine <Alt L>
  1342.       This command allows you to mark a Block in whole line increments.
  1343.       In other words, the Block will contain complete lines only and no
  1344.       portions of lines.  To use this command place the cursor anywhere
  1345.       on the first line of the text you wish to mark and press <Alt L>.
  1346.       (Notice that the line is immediately marked.)  Now, move the
  1347.       cursor (the Block will "follow" the cursor) to the last line of
  1348.       text to be marked and press <Alt L> again.  You now have a marked
  1349.       Block, ready for manipulation.
  1350.  
  1351.  
  1352.     ■ DropAnchor <Alt A>
  1353.       This command allows you to mark a Block one character at a time.
  1354.       In other words, the Block will contain a stream of characters
  1355.       (which can span over multiple lines).  To use this command place
  1356.       the cursor over the first character of the text you wish to mark
  1357.       and press <Alt A>.  Then begin moving the cursor toward the end of
  1358.       the text to be marked.  Notice that the Block "follows" the cursor
  1359.       position.  Once the cursor is placed over the last character to be
  1360.       marked, press <Alt A> again.  You now have a marked Block, ready
  1361.       for manipulation.
  1362.  
  1363.                                1-16
  1364.  
  1365.     ■ MarkCharacter
  1366.       This command works just like DropAnchor except that while marking
  1367.       the Block, the cursor is not included within the Block.
  1368.  
  1369.       MarkCharacter is provided as a replacement for the DropAnchor
  1370.       command.  If you want the cursor position included in character
  1371.       Blocks, then continue to use DropAnchor; otherwise, replace the
  1372.       DropAnchor command with this command in the QCONFIG.DAT file.
  1373.       Refer to the "Keyboard Configuration" section of Chapter 2 for
  1374.       more information on changing QEdit command assignments.
  1375.  
  1376.  
  1377.     ■ MarkColumn <Alt K>
  1378.       This command allows you to mark one or more columns of text.  To
  1379.       use this command place the cursor over the upper left-hand
  1380.       character of the text you wish to mark and press <Alt K>.  Then
  1381.       begin moving the cursor to the right and/or downward.  Notice that
  1382.       the Block "follows" the cursor position.  Once the cursor is
  1383.       placed over the lower right-hand character of the Block, press
  1384.       <Alt K> again.  You now have a marked Block, ready for
  1385.       manipulation.
  1386.  
  1387.     ┌─────────────────────────────────┐
  1388.     │ QEdit Tip:                      │
  1389.     │   When using the MarkLine,      │
  1390.     │   MarkCharacter, MarkColumn, and│
  1391.     │   DropAnchor commands, it is not│
  1392.     │   necessary to mark the end of  │
  1393.     │   the Block.  QEdit will assume │
  1394.     │   the end of the Block to be the│
  1395.     │   current cursor position for   │
  1396.     │   DropAnchor, MarkCharacter, and│
  1397.     │   MarkColumn and the current    │
  1398.     │   cursor line for MarkLine.     │
  1399.     │   Marking the end of the Block  │
  1400.     │   is only necessary when moving │
  1401.     │   or copying text within the    │
  1402.     │   same file.                    │
  1403.     └─────────────────────────────────┘
  1404.  
  1405.     ■ MarkBlockBegin <Ctrl KB> and MarkBlockEnd <Ctrl KK>
  1406.       This is another method of marking a Block one character at a time.
  1407.       To mark a Block with this command, place the cursor over the first
  1408.       character of the text you wish to mark and press <Ctrl KB>.  Then
  1409.       position the cursor one character past the end of the text that is
  1410.       to be marked and press <Ctrl KK>.  The Block is now marked and
  1411.       ready for manipulation.
  1412.  
  1413.     ■ UnmarkBlock <Alt U>
  1414.       Entering the UnmarkBlock command causes the currently marked Block
  1415.       to be unmarked.
  1416.  
  1417.     QEdit allows you to mark one Block at a time.  If you mark a Block
  1418.     and then go elsewhere in the file and attempt to mark another Block,
  1419.     QEdit will simply extend the first Block by including all the text
  1420.     between the original Block and the current cursor position.  If you
  1421.     mark a Block in one file and then go to another file and mark a
  1422.     Block, QEdit will automatically unmark the Block in the first file.
  1423.  
  1424.                                1-17
  1425.  
  1426.  
  1427.     Also, if you mix types of Block marking, by entering MarkLine
  1428.     followed by DropAnchor or vice-versa, QEdit will mark the Block
  1429.     according to the last command entered.
  1430.  
  1431.  
  1432.     Manipulating Blocks Directly
  1433.  
  1434.     QEdit provides several ways to manipulate a marked Block. The
  1435.     following commands act directly on a marked Block.
  1436.  
  1437.     ┌─────────────────────────────────┐
  1438.     │ QEdit Tip:                      │
  1439.     │   When Copying or Moving Blocks:│
  1440.     │                                 │
  1441.     │   Blocks marked using the Drop- │
  1442.     │   Anchor, MarkCharacter,        │
  1443.     │   MarkColumn, and               │
  1444.     │   MarkBlockBegin/End            │
  1445.     │   commands will always be       │
  1446.     │   inserted beginning at the     │
  1447.     │   current cursor position.      │
  1448.     │                                 │
  1449.     │   Blocks marked using the Mark- │
  1450.     │   Line command will be inserted │
  1451.     │   at either the line before or  │
  1452.     │   the line after the current    │
  1453.     │   cursor line.  Refer to the    │
  1454.     │   "General Options" section of  │
  1455.     │   Chapter 2 for more            │
  1456.     │   information.                  │
  1457.     └─────────────────────────────────┘
  1458.  
  1459.  
  1460.     ■ CopyBlock <Alt C>
  1461.       This command makes a copy of the marked Block and inserts it where
  1462.       you decide.  You can insert this copy of the Block at some other
  1463.       place in the same file or in another file.  The original Block of
  1464.       text, from which you made the copy, is not affected.
  1465.  
  1466.       To use this command, first mark the Block as described above.
  1467.       Next, move the cursor to the position in the file where you wish
  1468.       to insert the marked text.  (Or, if you have multiple files loaded
  1469.       and wish to copy text from one file to another, use the NextFile,
  1470.       PrevFile or EditFile commands to get a new current file and
  1471.       likewise position the cursor.)  Now enter the CopyBlock <Alt C>
  1472.       command.  The Block will be inserted at the new position.  You may
  1473.       notice, after you use CopyBlock, that the newly inserted Block of
  1474.       text is now marked and the original Block is unmarked.  To unmark
  1475.       the copied Block, enter the UnmarkBlock command.
  1476.  
  1477.       QEdit provides an easy method for copying the same Block
  1478.       repeatedly. Refer to the Copy and Paste commands in the following
  1479.       section for more information.
  1480.  
  1481.  
  1482.     ■ CopyOverBlock <Alt Z>
  1483.       This command is for use with column Blocks only.  It works just
  1484.       like CopyBlock except the Block is copied to the current cursor
  1485.       position by overlaying existing text and without shifting text to
  1486.       the right.
  1487.  
  1488.                                1-18
  1489.  
  1490.  
  1491.  
  1492.     ■ MoveBlock <Alt M>
  1493.       This command works exactly like CopyBlock with one exception: Upon
  1494.       entering the MoveBlock <Alt M> command, the originally marked
  1495.       Block is deleted from the file.
  1496.  
  1497.       As with the CopyBlock command, you can move a Block to another
  1498.       part of the same file or from one file to another.
  1499.  
  1500.       QEdit provides an easy method for deleting a Block from its
  1501.       original position and inserting it repeatedly at other positions.
  1502.       Refer to the Cut and Paste commands in the following section for
  1503.       more information.
  1504.  
  1505.  
  1506.     ■ DeleteBlock <Alt G>.
  1507.       This command simply deletes a marked Block of text from the file.
  1508.       To use this command, first mark a Block of text to be deleted,
  1509.       then enter the DeleteBlock command.  The marked text will be
  1510.       deleted from the file.  (Deleted Blocks will be placed in the Kill
  1511.       buffer. Refer to "The Kill Buffer" section in this chapter for
  1512.       more information.)
  1513.  
  1514.       This command will not delete column Blocks.  Use the Cut command
  1515.       instead to delete column Blocks from your text.
  1516.  
  1517.     ■ ShiftLeft <Shift F7> and ShiftRight <Shift F8>
  1518.       These commands allow the User to shift text contained in a Block
  1519.       to the left or right. To use these commands, first mark a Block.
  1520.       Now enter ShiftLeft or ShiftRight.  The entire marked Block of
  1521.       text will be shifted one column to the left or right respectively.
  1522.       If there is no marked Block of text or the cursor is outside of
  1523.       the marked Block, the current cursor line will be shifted. This
  1524.       command is very useful for changing indentation for portions of
  1525.       text or source code.
  1526.  
  1527.  
  1528.     Manipulating Blocks Using Scrap Buffers
  1529.  
  1530.     QEdit provides an extremely helpful device for quickly manipulating
  1531.     Blocks of text.  This device consists of a Scrap Buffer and four
  1532.     QEdit commands which act on the Scrap Buffer.
  1533.  
  1534.     The Scrap Buffer is a temporary holding area for marked Blocks of
  1535.     text.  The commands Cut, Copy, Paste, and PasteOver are solely
  1536.     responsible for placing text into the Scrap Buffer and copying text
  1537.     from the Scrap Buffer.
  1538.  
  1539.                                1-19
  1540.  
  1541.     When you issue a Copy or Cut command (we will discuss how to use
  1542.     these in the following section ), the marked Block is placed into
  1543.     the Scrap Buffer.  The next time you Copy or Cut a Block into the
  1544.     Scrap Buffer, the previous contents of the Scrap Buffer are deleted
  1545.     and replaced with the new Block.
  1546.  
  1547.     You can repeatedly use the Paste and PasteOver commands as many
  1548.     times as needed to insert a copy of the Block held in the Scrap
  1549.     Buffer at multiple positions in your file or files.  The Paste and
  1550.     PasteOver commands do not purge the contents of the Scrap Buffer.
  1551.  
  1552.  
  1553.  
  1554.     ■ Copy <grey +> and Paste <grey *> or PasteOver <Ctrl PrtSc>
  1555.       To copy a section of text from its present position and insert it
  1556.       somewhere else:
  1557.  
  1558.       1. Mark the text using the Block marking commands.
  1559.  
  1560.       2. Enter Copy <grey +>.  This places a copy of the marked text
  1561.          into the Scrap Buffer.
  1562.  
  1563.       3. If you want to insert the text somewhere else within the same
  1564.          file, use the cursor movement commands to place the cursor
  1565.          where you wish to insert the text.
  1566.  
  1567.       4. If you want to insert the text in another file, switch to that
  1568.          file using the NextFile, PrevFile, or EditFile command to
  1569.          access that file.  Then, likewise place the cursor at the
  1570.          desired position.
  1571.  
  1572.       5. Enter Paste <grey *> to insert the text.  If you have copied a
  1573.          column Block into the Scrap Buffer and wish to insert it by
  1574.          overlaying existing text then use PasteOver <Ctrl PrtSc>
  1575.          instead of Paste.
  1576.  
  1577.       Since Paste and PasteOver leave the contents of the Scrap Buffer
  1578.       intact, you can make multiple insertions in the same or different
  1579.       files. Simply move the cursor to the file and position where you
  1580.       wish to make additional insertions and enter Paste <grey *> or
  1581.       PasteOver <Ctrl PrtSc>.  Please note that the next time you issue
  1582.       a Cut or Copy command, the previous contents of the Scrap Buffer
  1583.       will be discarded.
  1584.  
  1585.  
  1586.     ■ Cut <grey -> and Paste <grey *> or PasteOver <Ctrl PrtSc>
  1587.       Cut and Paste/PasteOver work exactly like Copy and Paste/PasteOver
  1588.       except that Cut will delete the marked Block from the file.  You
  1589.       can still make multiple insertions of the text using the Paste or
  1590.       PasteOver Commands.
  1591.  
  1592.                                1-20
  1593.  
  1594.     ┌─────────────────────────────────┐
  1595.     │ QEdit Tip:                      │
  1596.     │   QEdit can be configured to    │
  1597.     │   have the Cut and Copy commands│
  1598.     │   act on the current cursor line│
  1599.     │   if no Block is marked.        │
  1600.     │   Refer to the "Advanced        │
  1601.     │   Options" section of Chapter 2 │
  1602.     │   for more information.         │
  1603.     └─────────────────────────────────┘
  1604.  
  1605.  
  1606.     Manipulating Blocks Using Scratch Buffers
  1607.  
  1608.     A Scratch Buffer is a special type of buffer to which you assign a
  1609.     name.  QEdit allows you to create and name up to 99 Scratch Buffers
  1610.     for each editing session.  These can be useful if you have several
  1611.     different Blocks of text that you want to insert in multiple
  1612.     locations.  The commands StoreScrbuff <Ctrl BS>, AppendScrbuff <Ctrl
  1613.     BA>, and GetScrbuff <Ctrl BL> are used to place text in, and
  1614.     retrieve text from, a Scratch Buffer.  Whenever you issue one of
  1615.     these commands, QEdit will ask you for the name of the Scratch
  1616.     Buffer.  The contents of all Scratch Buffers are discarded when the
  1617.     editor is terminated.
  1618.  
  1619.     ■ StoreScrbuff <Ctrl BS> and AppendScrbuff <Ctrl BA>
  1620.  
  1621.       To place a Block of text into a named buffer:
  1622.  
  1623.       1. Mark the Block.
  1624.  
  1625.       2. If you want to create a new Scratch Buffer containing the
  1626.          marked Block, enter StoreScrbuff <Ctrl BS>.  (This command is
  1627.          also used if you wish to replace the current contents of a
  1628.          Scratch Buffer with the marked Block.)  If you want to append
  1629.          the marked Block to the current contents of the Scratch Buffer,
  1630.          enter AppendScrbuff <Ctrl BA>.
  1631.  
  1632.       3. QEdit will prompt for the name of the Scratch Buffer.
  1633.  
  1634.          ┌─────────────────────────────────────────────────────────────────┐
  1635.          │Store (Append) to buffer: <Esc = abort>                          │
  1636.          │                                                                 │
  1637.          └─────────────────────────────────────────────────────────────────┘
  1638.  
  1639.       4. Enter a name.  It is best to use a name which reflects the
  1640.          contents of the buffer and is easily remembered.
  1641.  
  1642.       The Block is now stored in a Scratch Buffer under the assigned
  1643.       name.
  1644.  
  1645.       ■ GetScrbuff <Ctrl BL>
  1646.         To retrieve the contents of a named Scratch Buffer and insert it
  1647.         at the current cursor position:
  1648.  
  1649.         1. Position the cursor where you wish the contents of the named
  1650.            Scratch Buffer to be inserted.
  1651.  
  1652.                                1-21
  1653.  
  1654.         2. Enter GetScrbuff <Ctrl BL>.  QEdit will prompt for the name
  1655.            of the Scratch Buffer to be retrieved.
  1656.  
  1657.            ┌─────────────────────────────────────────────────────────────────┐
  1658.            │Get from buffer: <Esc = abort>                                   │
  1659.            │                                                                 │
  1660.            └─────────────────────────────────────────────────────────────────┘
  1661.  
  1662.         3. Enter the name of the desired Scratch Buffer.
  1663.  
  1664.         4. Repeat the above steps whenever you want to insert the
  1665.            contents of a Scratch Buffer into your text.
  1666.  
  1667.  
  1668.     Examples of Block Commands
  1669.  
  1670.     This section contains examples of commonly used Block Commands.
  1671.  
  1672.     ■ Copying or moving a Block within the same file.
  1673.  
  1674.       1. Position the cursor at the beginning of the Block to be copied
  1675.          or moved.
  1676.  
  1677.       2. Enter DropAnchor <Alt A> to mark a stream of characters, or
  1678.          MarkLine <Alt L> to mark whole lines, or MarkColumn <Alt K> to
  1679.          mark a column of text.
  1680.  
  1681.       3. Position the cursor at the end of the Block to be copied or
  1682.          moved.
  1683.  
  1684.       4. Enter DropAnchor, MarkLine, or MarkColumn again to mark the end
  1685.          of the Block.
  1686.  
  1687.       5. Move the cursor to the location in the file where you want to
  1688.          insert the marked Block.
  1689.  
  1690.       6. Enter CopyBlock <Alt C>, CopyOverBlock <Alt Z> (column Blocks
  1691.          only), or MoveBlock <Alt M>.
  1692.  
  1693.       7. Enter UnmarkBlock <Alt U> to unmark the Block.
  1694.  
  1695.       The Block has now been copied or moved.
  1696.  
  1697.  
  1698.     ■ Copying or moving a Block to another file.
  1699.  
  1700.       1. Position the cursor at the beginning of the Block to be copied
  1701.          or moved.
  1702.  
  1703.       2. Enter DropAnchor <Alt A> to mark a stream of characters, or
  1704.          MarkLine <Alt L> to mark whole lines, or MarkColumn <Alt K> to
  1705.          mark a column of text.
  1706.  
  1707.                                1-22
  1708.  
  1709.       3. Position the cursor at the end of the Block to be copied or
  1710.          moved.
  1711.  
  1712.       4. Switch to the "target" file using the file commands EditFile,
  1713.          NextFile, or PrevFile.
  1714.  
  1715.       5. Move the cursor to the location in the file where you want to
  1716.          insert the marked Block.
  1717.  
  1718.       6. Enter CopyBlock <Alt C>, CopyOverBlock <Alt Z> (column Blocks
  1719.          only), or MoveBlock <Alt M>.
  1720.  
  1721.       7. Enter UnmarkBlock <Alt U> to unmark the Block.
  1722.  
  1723.       The Block has now been copied or moved.
  1724.  
  1725.  
  1726.     ■ Copying or moving a Block for multiple insertions in the same
  1727.       file.
  1728.  
  1729.       If you want to insert the same Block at several positions within a
  1730.       file, follow these steps:
  1731.  
  1732.       1. Position the cursor at the beginning of the Block to be copied
  1733.          or moved.
  1734.  
  1735.       2. Enter DropAnchor <Alt A> to mark a stream of characters, or
  1736.          MarkLine <Alt L> to mark whole lines, or MarkColumn <Alt K> to
  1737.          mark a column of text.
  1738.  
  1739.       3. Position the cursor at the end of the Block to be copied or
  1740.          moved.
  1741.  
  1742.       4. If you want to leave the Block in its original position and
  1743.          insert copies of it at other locations, then enter Copy <grey+>.
  1744.  
  1745.          If you want to delete the Block from its original position and
  1746.          insert copies of it at other locations, then enter Cut <grey->.
  1747.  
  1748.          The Block is now stored in the Scrap Buffer.
  1749.  
  1750.       5. Move the cursor to the location in the file where you want to
  1751.          insert the Block.
  1752.  
  1753.       6. Enter Paste <grey *> or PasteOver <Ctrl PrtSc> (column Blocks
  1754.          only).
  1755.  
  1756.       The Block is now inserted.  Repeat steps 5 and 6 for each
  1757.       additional insertion.
  1758.  
  1759.                                1-23
  1760.  
  1761.  
  1762.  
  1763.     ■ Copying or moving a Block for multiple insertions in more than one
  1764.       file.
  1765.  
  1766.       If you want to insert the same Block at several positions in more
  1767.       than one file, follow these steps:
  1768.  
  1769.       1. Position the cursor at the beginning of the Block to be copied
  1770.          or moved.
  1771.  
  1772.       2. Enter DropAnchor <Alt A> to mark a stream of characters, or
  1773.          MarkLine <Alt L> to mark whole lines, or MarkColumn <Alt K> to
  1774.          mark a column of text.
  1775.  
  1776.       3. Position the cursor at the end of the Block to be copied or
  1777.          moved.
  1778.  
  1779.       4. If you want to leave the Block in its original position and
  1780.          insert copies of it at other locations, then enter Copy <grey+>.
  1781.  
  1782.          If you want to delete the Block from its original position and
  1783.          insert copies of it at other locations, then enter Cut <grey->.
  1784.  
  1785.          The Block is now stored in the Scrap Buffer.
  1786.  
  1787.       5. Switch to the "target" file using the file commands EditFile,
  1788.          NextFile, or PrevFile.
  1789.  
  1790.       6. Move the cursor to the location in the file where you want to
  1791.          insert the Block.
  1792.  
  1793.       7. Enter Paste <grey *> or PasteOver <Ctrl PrtSc> (column Blocks
  1794.          only).
  1795.  
  1796.       The Block is now inserted.  Repeat steps 5-7 for each additional
  1797.       insertion.
  1798.  
  1799.     ■ Copying multiple Blocks for insertion in one or more files.
  1800.  
  1801.       If you have several Blocks that you want to insert in several
  1802.       different files, follow these steps:
  1803.  
  1804.       1. Position the cursor at the beginning of the first Block.
  1805.  
  1806.       2. Enter DropAnchor <Alt A> to mark a stream of characters, or
  1807.          MarkLine <Alt L> to mark whole lines, or MarkColumn <Alt K> to
  1808.          mark a column of text.
  1809.  
  1810.       3. Position the cursor at the end of the first Block.
  1811.  
  1812.       4. Enter AppendScrbuff <Ctrl BA> if you want to append to an
  1813.          existing Scratch Buffer.  Otherwise, enter StoreScrbuff
  1814.          <Ctrl BS> to create or overwrite an existing Scratch Buffer.
  1815.  
  1816.                                1-24
  1817.  
  1818.  
  1819.       5.  QEdit will prompt for the name of the buffer.  Enter a name.
  1820.           (It is best to use a name which reflects the contents of the
  1821.           buffer and is easily remembered).
  1822.  
  1823.           The Block is now stored in a Scratch Buffer under the assigned
  1824.           name.  Repeat steps 1-5 for each additional Block you want to
  1825.           store.
  1826.  
  1827.       6. Switch to the "target" file using the file commands EditFile,
  1828.          NextFile, or PrevFile.
  1829.  
  1830.       7. Move the cursor to the location in the file where you want to
  1831.          insert a Block.
  1832.  
  1833.       8. Enter GetScrbuff <Ctrl BL>.  QEdit will prompt for the name of
  1834.          the Scratch Buffer.  Enter the name of the desired Scratch
  1835.          Buffer for insertion.
  1836.  
  1837.       Repeat steps 6 through 8 for each insertion of a stored Block.
  1838.  
  1839.     Non-Block Commands
  1840.     ─────────────────────────────────────────────────────────────────────────
  1841.  
  1842.     In addition to QEdit's array of Block commands, there are also many
  1843.     commands for manipulating your text which do not depend on marked
  1844.     Blocks.  This section explains each of these non-Block commands in
  1845.     detail.
  1846.  
  1847.  
  1848.     Adding Text
  1849.  
  1850.     ■ AddLine <F2>
  1851.       As its name implies, this command inserts a blank line in the
  1852.       text.  The line is added immediately below the current cursor
  1853.       line. The cursor is moved to the new line.  The cursor column does
  1854.       not change.
  1855.  
  1856.     ■ InsertLine <Alt F2>
  1857.       This command inserts a blank line in the text above the cursor
  1858.       line.  The cursor remains on the new line and the cursor column
  1859.       does not change.
  1860.  
  1861.     ■ Literal <Ctrl P>
  1862.       The Literal command is used to insert control characters into the
  1863.       text.  To use this command, enter <Ctrl P> followed by a control
  1864.       character.  The control character will be inserted into the text.
  1865.       For example, to insert a formfeed character (ASCII 12) in the
  1866.       text, enter <Ctrl P> <Ctrl L>.
  1867.  
  1868.                                1-25
  1869.  
  1870.       This command is handy for entering the control characters
  1871.       represented by ASCII decimal values 1 through 26.  Simply enter
  1872.       <Ctrl P> followed by <Ctrl A> for ASCII character 1, or <Ctrl B>
  1873.       for ASCII character 2 and so on, up to <Ctrl Z> for ASCII
  1874.       character 26.
  1875.     ┌─────────────────────────────────┐
  1876.     │ QEdit Tip:                      │
  1877.     │   An alternate and perhaps      │
  1878.     │   easier method of entering     │
  1879.     │   control characters or any     │
  1880.     │   ASCII character into your text│
  1881.     │   is to hold down the <Alt> key │
  1882.     │   and enter the decimal         │
  1883.     │   equivalent of the ASCII       │
  1884.     │   character using the numeric   │
  1885.     │   keypad.  For example, to      │
  1886.     │   insert a formfeed character   │
  1887.     │   (ASCII 12) in the text, just  │
  1888.     │   enter <Alt 12> using the      │
  1889.     │   numeric keypad.               │
  1890.     │                                 │
  1891.     │   If a linefeed character (ASCII│
  1892.     │   10) is entered, QEdit will    │
  1893.     │   split the line at this        │
  1894.     │   position the next time the    │
  1895.     │   file is edited.               │
  1896.     └─────────────────────────────────┘
  1897.     ■ ToggleBoxDraw <Shift F1>
  1898.       This is a specialized command which is really a mode of operation
  1899.       that can be switched ON or OFF.  If switched ON, the cursor
  1900.       movement keys (up, down, right, left) can be used to "draw" lines
  1901.       in the text.  This can be very useful for creating graphs and
  1902.       tables.  To switch Box Drawing mode ON, enter <Shift F1>.  To
  1903.       switch OFF, enter <Shift F1> again.
  1904.  
  1905.     ■ ToggleEnterMatching <Esc><O><E>
  1906.       This is also a specialized command which is really a mode of
  1907.       operation that can be switched ON or OFF.  If switched ON, QEdit
  1908.       will automatically insert into the text a corresponding ), ], or "
  1909.       character each time a (, [, or " character, respectively, is
  1910.       entered.  To switch EnterMatching mode ON, enter <Esc><O><E>.  To
  1911.       switch OFF, enter <Esc><O><E> again.
  1912.  
  1913.  
  1914.     Copying Text
  1915.  
  1916.     ■ GetPrev <Ctrl - (dash)>
  1917.       This command copies the character directly above the cursor onto
  1918.       the cursor line.  To get an idea of how this command works, place
  1919.       the cursor at the beginning of any line which has text on the line
  1920.       immediately above it.  Now press <Ctrl - (dash)> and hold it down.
  1921.       The cursor will move to the right while copying the the characters
  1922.       from the line above.
  1923.  
  1924.     ■ DupLine <F4>
  1925.       This command simply makes a copy of the current cursor line and
  1926.       inserts this copy on the line immediately below the cursor line.
  1927.       The cursor is placed on the new line.
  1928.  
  1929.                                1-26
  1930.  
  1931.     ■ Copy <grey +> and Paste <grey *>
  1932.       Refer to the "Block Commands" section in this chapter for a
  1933.       complete explanation of these commands.  The commands are included
  1934.       here because, if desired, the User can configure QEdit so that
  1935.       these commands act on the current cursor line in the same manner
  1936.       in which they act on Blocks.  For more information on how to
  1937.       configure this option, refer to the "Advanced Options" section of
  1938.       Chapter 2.
  1939.  
  1940.  
  1941.     Moving Text
  1942.  
  1943.     ■ Align
  1944.       This command lines up the left-most character of the cursor line
  1945.       with the left-most character of the line above it.  This allows
  1946.       you to align portions of text which require a common left margin.
  1947.       This command also moves the cursor down one line; thus, large
  1948.       portions of text can be aligned very quickly by entering this
  1949.       command and holding the command key down.
  1950.  
  1951.     ■ JoinLine  <Alt J>
  1952.       This command will delete the line below the current cursor line
  1953.       and append it to the end of the cursor line.
  1954.  
  1955.       If the cursor is positioned on or before the last non-blank
  1956.       character of the line, the line below will be appended immediately
  1957.       following the last non-blank character.
  1958.  
  1959.       If the cursor is positioned beyond the last non-blank character of
  1960.       the line, the line below will be appended beginning at the current
  1961.       cursor position.
  1962.  
  1963.       If the line below the cursor line is blank, the blank line will be
  1964.       deleted.
  1965.  
  1966.     ■ SplitLine <Alt S>
  1967.       This command will delete all text on and to the right of the
  1968.       cursor on the cursor line and will insert this text on a new line
  1969.       immediately below the cursor line.  The cursor position will not
  1970.       change.
  1971.  
  1972.     ■ Return <Enter>
  1973.       Before reading the explanation of the Return command, it may be
  1974.       helpful to review the discussion of Insert mode in the "Modes"
  1975.       section in this chapter.
  1976.  
  1977.       If the editor is in Insert mode, this command performs like the
  1978.       SplitLine command; that is, all text on and to the right of the
  1979.       cursor on the cursor line will be deleted and inserted on a new
  1980.       line immediately below the cursor line.  The cursor, however, will
  1981.       be placed on the new line.
  1982.  
  1983.       If the editor is not in Insert mode, this command will simply
  1984.       place the cursor at the beginning of the line below the cursor
  1985.       line.  No text will be affected.
  1986.  
  1987.                                1-27
  1988.  
  1989.       If the editor is in AutoIndent mode, the cursor will be placed at
  1990.       the left margin instead of at the beginning of the line.
  1991.  
  1992.     ┌─────────────────────────────────┐
  1993.     │ QEdit Tip:                      │
  1994.     │   QEdit can be configured so    │
  1995.     │   that the Return command does  │
  1996.     │   not split lines in Insert     │
  1997.     │   mode.                         │
  1998.     │   Refer to the "Advanced        │
  1999.     │   Options" section of Chapter 2 │
  2000.     │   for more information.         │
  2001.     └─────────────────────────────────┘
  2002.  
  2003.     ■ Cut <grey -> and Paste <grey *>
  2004.       Refer to the "Block Commands" section in this chapter for a
  2005.       complete explanation of these commands.  The commands are included
  2006.       here because, if desired, the User can configure QEdit so that
  2007.       these commands act on the current cursor line in the same manner
  2008.       in which they act on Blocks.  For more information on how to
  2009.       configure this option, refer to the "Advanced Options" section of
  2010.       Chapter 2.
  2011.  
  2012.     ■ ShiftLeft <Shift F7> and ShiftRight <Shift F8>
  2013.       Refer to the "Block Commands" section in this chapter for a
  2014.       complete explanation of these commands.  The commands are included
  2015.       here because, if there is no marked Block in the text, these
  2016.       commands will act on the current cursor line.
  2017.  
  2018.  
  2019.     Deleting And Undeleting Text
  2020.  
  2021.     ■ Backspace <Backspace> and DelLtWord <Ctrl Backspace>
  2022.       If Insert mode is ON, the Backspace command deletes the character
  2023.       to the left of the cursor.  The text to the right of the cursor is
  2024.       pulled behind the cursor as it moves to the left.  If the cursor
  2025.       is in column one and you enter Backspace, the cursor line is
  2026.       appended to the line immediately above.
  2027.  
  2028.       If Insert mode is OFF, the Backspace command works the same as
  2029.       above except the text to the right of the cursor is not pulled
  2030.       behind the cursor as it moves left.
  2031.  
  2032.       The DelLtWord command is a backspace for "words".  It works just
  2033.       like the Backspace command, except that it deletes all characters
  2034.       from the cursor to the beginning of the previous word.
  2035.  
  2036.     ■ DelCh <Del> and DelRtWord <Ctrl T>
  2037.       DelCh will delete the character at the cursor position and pull
  2038.       the text to the right of the cursor, one column to the left.
  2039.  
  2040.       If the cursor position is to the right of the last non-blank
  2041.       character on the cursor line, the line immediately below will be
  2042.       appended to the cursor line.
  2043.  
  2044.                                1-28
  2045.  
  2046.  
  2047.       The DelRtWord command is a character delete for "words".  It works
  2048.       just like the DelCh command, except that it deletes all characters
  2049.       from the cursor to the beginning of the following word.
  2050.  
  2051.     ■ DelToEol <F6>
  2052.       This command deletes the character at the cursor position and all
  2053.       text to the right of the cursor on the current cursor line.  The
  2054.       cursor position does not change.
  2055.  
  2056.     ■ DelLine <Alt D>
  2057.       This command deletes the current cursor line from the text. All
  2058.       text below the deleted line is shifted up one line.
  2059.  
  2060.     ■ UndoCursorline  <Ctrl QL>
  2061.       This command allows you to reverse any changes you have made to
  2062.       the cursor line.  This can be helpful if you accidentally delete
  2063.       or change part of a line, or you just change your mind and want
  2064.       the cursor line back the way it was.  This command must be issued
  2065.       before the cursor is moved from the current cursor line and before
  2066.       any file or window commands are entered.  Changes made using the
  2067.       FindReplace command cannot be reversed with this command.
  2068.  
  2069.     ■ UnKill <Ctrl U>
  2070.       This command allows you to retrieve text that has been deleted by
  2071.       the DeleteBlock, DelLine, DelRtWord, or DelToEol commands.  Refer
  2072.       to "The Kill Buffer" section in this chapter for a complete
  2073.       explanation on the use of this command.
  2074.  
  2075.     Replacing Text
  2076.  
  2077.     QEdit provides the ability to search for specific strings of
  2078.     characters throughout your text and then replace all, some, or none
  2079.     of them with another string of characters.  (If you want to search
  2080.     for strings of characters without replacing them, use the Find
  2081.     command which is described in the "Moving Through a File" section in
  2082.     this chapter.)
  2083.  
  2084.     ■ FindReplace <Ctrl QA>
  2085.       This command will search for a specific string of characters in
  2086.       the current file, and optionally, replace it with another string
  2087.       of characters.
  2088.  
  2089.       Upon entering the FindReplace command, QEdit will prompt for the
  2090.       string of characters for which to search.
  2091.  
  2092.       ┌─────────────────────────────────────────────────────────────────┐
  2093.       │Search For: <Esc = Abort>                                        │
  2094.       │                                                                 │
  2095.       └─────────────────────────────────────────────────────────────────┘
  2096.  
  2097.       Enter the desired string of characters and press <Enter>.
  2098.  
  2099.                                1-29
  2100.  
  2101.       QEdit will then prompt for a new string of characters (to replace
  2102.       the old string).
  2103.  
  2104.       ┌─────────────────────────────────────────────────────────────────┐
  2105.       │Change to: <Esc = Abort>                                         │
  2106.       │                                                                 │
  2107.       └─────────────────────────────────────────────────────────────────┘
  2108.  
  2109.       Enter the new string of characters and press <Enter>.
  2110.  
  2111.       QEdit will then prompt for the search options you wish to use.
  2112.  
  2113.       ┌───────────────────────────────────────────────────────────────┐
  2114.       │Options [IWBN] (Ignore, Words, Backward, No Ask) <Esc = Abort> │
  2115.       │I                                                              │
  2116.       └───────────────────────────────────────────────────────────────┘
  2117.  
  2118.       Enter the letter(s) corresponding to the option(s) you want and
  2119.       press <Enter>.  The available options are:
  2120.  
  2121.         [I] = Ignore the case (capital or lowercase) of the search
  2122.               string.  For example, "Hello" would match "hello" when
  2123.               this option is chosen.  This option is set ON by default.
  2124.  
  2125.         [W] = Search for whole words only.  For example, when this
  2126.               option is chosen, the word "sent" will match only the
  2127.               actual word "sent".  Otherwise, any other words that
  2128.               contain the string (such as "sentence" or "absent") would
  2129.               also match.
  2130.  
  2131.         [B] = Search backward from the current cursor position.  If you
  2132.               choose "B", QEdit will search backward from the cursor
  2133.               position toward the beginning of the file.  Otherwise, it
  2134.               will search from the cursor position toward the end of the
  2135.               file.
  2136.  
  2137.         [N] = Find and replace without prompting.  If you choose "N",
  2138.               QEdit will find and replace every occurrence of the search
  2139.               string, without asking you if you want to replace each
  2140.               individual occurrence.
  2141.  
  2142.       If you select the "No Ask" option, QEdit will find and replace
  2143.       every occurrence of the search string with no further User
  2144.       intervention.  If you do not select the "No Ask" option, QEdit
  2145.       will prompt at every occurrence of the search string with:
  2146.  
  2147.       ┌───────────────────────────────────────┐
  2148.       │  Replace (Yes/No/Only/Global/Quit):   │
  2149.       └───────────────────────────────────────┘
  2150.  
  2151.       Valid responses are:
  2152.  
  2153.            <Y>es    - Replace the search string with the new string and
  2154.                       continue to the next occurrence.
  2155.            <N>o     - Do not replace the search string, but continue to
  2156.                       the next occurrence.
  2157.  
  2158.                                1-30
  2159.  
  2160.            <O>nly   - Replace the search string with the new string and
  2161.                       quit.
  2162.            <G>lobal - Replace the search string with the new string and
  2163.                       replace all other occurrences with no further
  2164.                       prompts.
  2165.            <Q>uit   - Abort the FindReplace process.
  2166.  
  2167.  
  2168.     ■ RepeatFind <Ctrl L>
  2169.       This command will reissue the previous Find or FindReplace command
  2170.       using the same character strings and options.
  2171.  
  2172.  
  2173.     The Kill Buffer - A Safety Net
  2174.     ─────────────────────────────────────────────────────────────────────────
  2175.  
  2176.     QEdit maintains a temporary storage area for deleted text.  This
  2177.     provides the User a safeguard against incorrectly or inadvertently
  2178.     deleting text.  This recovery mechanism is automatically in effect
  2179.     when QEdit is running.  No action is required from the User until
  2180.     there is a need to recover deleted text.
  2181.  
  2182.     The temporary storage area is called the Kill Buffer.  QEdit will
  2183.     place into the Kill Buffer text which has been deleted by these
  2184.     commands:
  2185.  
  2186.                         DeleteBlock  <Alt G>
  2187.                         DelLine      <Alt D>
  2188.                         DelRtWord    <Ctrl T>
  2189.                         DelToEol     <F6>
  2190.  
  2191.     To understand how the Kill Buffer works and how text is recovered
  2192.     from the Kill Buffer, refer to the illustration below.
  2193.  
  2194.  
  2195.                              The Kill Buffer
  2196.  
  2197.            Entry    Command
  2198.            Number   Entered      Buffer Contents             top
  2199.           ┌───────┬────────────┬────────────────────────────────┐
  2200.           │  4    │ DelToEol   │ part of this line was deleted. │
  2201.           ├───────┼────────────┼────────────────────────────────┤
  2202.           │  3    │ DelRtWord  │ (1 word deleted)               │
  2203.           ├───────┼────────────┼────────────────────────────────┤
  2204.           │  2    │ DelLine    │ This entire line was deleted.  │
  2205.           ├───────┼────────────┼────────────────────────────────┤
  2206.           │  1    │ DelLine    │ This entire line was deleted.  │
  2207.           ├───────┼────────────┼────────────────────────────────┤
  2208.           │ empty │            │                                │
  2209.           ├───────┼────────────┼────────────────────────────────┤
  2210.           │ empty │            │                                │
  2211.           └───────┴────────────┴────────────────────────────────┘
  2212.                                                            bottom
  2213.  
  2214.                                1-31
  2215.  
  2216.  
  2217.     Each time one of the text deletion commands is used, a new entry is
  2218.     made in the Kill Buffer.  In the above example, four deletion
  2219.     commands have been issued.  The text from these four commands has
  2220.     been stored in the Kill Buffer from top to bottom. In other words,
  2221.     when the DelToEol command was issued (entry #4), the first three
  2222.     entries were pushed toward the bottom of the Kill Buffer and the
  2223.     newly deleted text was entered at the top.
  2224.  
  2225.     In the example, the Kill Buffer has enough room for six entries.
  2226.     When a seventh entry is made, the oldest entry, or entry number one,
  2227.     will be discarded from the Kill Buffer.  Once discarded from the
  2228.     Kill Buffer, that text can no longer be recovered.
  2229.  
  2230.     To recover deleted text, the UnKill <Ctrl U> command is used.  Each
  2231.     time the UnKill command is issued the most recent entry (the "top"
  2232.     entry of the Kill Buffer) is retrieved and restored to the file.
  2233.     This entry is then deleted from the Kill Buffer, and all remaining
  2234.     entries move toward the top of the buffer by one position. In the
  2235.     example, the first time the UnKill command is issued, entry #4 will
  2236.     be recovered.  Next, entry #3 will be recovered, and so on. Thus,
  2237.     recovering deleted text follows the rule of LIFO (last in - first
  2238.     out).  The last entry of deleted text will be the first one
  2239.     recovered and the first entry of deleted text will be the last one
  2240.     recovered.
  2241.  
  2242.     Here are some additional items of which to be aware regarding the
  2243.     Kill Buffer and its uses.
  2244.  
  2245.     ■ A separate Kill Buffer is maintained for each file loaded into
  2246.       QEdit.  The Kill Buffer for each file exists only as long as the
  2247.       file is loaded.
  2248.  
  2249.     ■ The default size of the Kill Buffer is 30 entries.  This may be
  2250.       changed using the QEdit configuration program. Refer to the
  2251.       "General Options" section of Chapter 2 for more information.
  2252.  
  2253.     ■ The text deleted using the DelLine, DelRtWord, and DelToEol
  2254.       commands will take up one entry in the Kill Buffer each time the
  2255.       commands are executed.  The text deleted using the DeleteBlock
  2256.       command will take up as many entries as there are lines in the
  2257.       Block.
  2258.  
  2259.       It is important to note that regardless of how large the Kill
  2260.       Buffer is configured to be, it may be possible to mark and delete
  2261.       a Block in the file which is larger than the buffer.  If this
  2262.       situation arises, QEdit will save the deleted text in the Kill
  2263.       Buffer from the bottom up.  For example, if a marked Block is 200
  2264.       lines long and five lines too large for the Kill Buffer, then the
  2265.       top five lines of the Block will not be loaded into the Kill
  2266.       Buffer.
  2267.  
  2268.     ■ When issuing the UnKill command to recover deleted text, deleted
  2269.       lines will be inserted immediately before the current cursor line,
  2270.       and deleted words will be inserted immediately before the current
  2271.       cursor position.
  2272.  
  2273.  
  2274.                                1-32
  2275.  
  2276.  
  2277.     Macros
  2278.     ─────────────────────────────────────────────────────────────────────────
  2279.  
  2280.     A macro is a series of commands and/or keystrokes which are assigned
  2281.     to a single key.  If you find that you are repeatedly entering the
  2282.     same series of commands and keystrokes (for example, a row of
  2283.     asterisks, three Returns, and then a Tab), using macros will allow
  2284.     you to easily assign these to a single key, such as <Shift F6>.
  2285.     Then, the next time you wish to enter a row of asterisks, three
  2286.     Returns, and a Tab, you will only have to press <Shift F6>.
  2287.  
  2288.     Creating, using, and saving macros for later use is both quick and
  2289.     simple.  By taking a few minutes to review the following sections,
  2290.     you should be able to save plenty of time and keystrokes in your
  2291.     future editing with the help of macros.
  2292.  
  2293.  
  2294.     Creating Macros
  2295.  
  2296.     Once you have decided to assign a series of commands and keystrokes
  2297.     to a single key, creating the macro is simply a matter of entering
  2298.     this series while QEdit "records" the macro.
  2299.  
  2300.     To create a macro follow these steps:
  2301.  
  2302.     1. Position the text and cursor to where you will begin entering the
  2303.        series of commands and keys.  (You may want to practice your
  2304.        series once or twice before actually recording the macro.)
  2305.  
  2306.     2. Enter the MacroRecord <Ctrl M> command.  An "R" will appear on
  2307.        the Status Line to indicate macro recording is ON.  The following
  2308.        message will appear:
  2309.  
  2310.        ┌────────────────────────────────────────────────────────┐
  2311.        │Assign to what key: (Enter for "scrap", Escape to Abort)│
  2312.        └────────────────────────────────────────────────────────┘
  2313.  
  2314.     3. Enter the key to which you want to assign the series of commands
  2315.        and keystrokes.  There are two requirements here.  The key must
  2316.        be a "configurable" key.  A list of all configurable keys is
  2317.        contained in Appendix B.  Also, the key cannot have a command
  2318.        already assigned to it.
  2319.  
  2320.        You may assign the macro to a "scrap" or temporary area by simply
  2321.        pressing <Enter>.  The scrap area will hold your macro until
  2322.        another macro is recorded.
  2323.  
  2324.     4. Enter the series of commands and keystrokes to be assigned. Note
  2325.        that the "R" still appears on the Status Line.
  2326.  
  2327.     5. Enter the MacroRecord <Ctrl M> command again.  Macro recording is
  2328.        now OFF.  The "R" no longer appears on the the Status Line.  The
  2329.        macro is now created and assigned to the key specified in step 3.
  2330.  
  2331.                                1-33
  2332.  
  2333.  
  2334.     Using Macros
  2335.  
  2336.     To use your macro, simply position the text and cursor properly and
  2337.     press the key to which you assigned the macro, or use the
  2338.     ExecuteScrap <Ctrl Enter> command to retrieve the latest macro from
  2339.     the scrap area. If the macro does not behave as you expected
  2340.     (perhaps you inadvertently hit an extraneous key while recording),
  2341.     simply repeat the above steps.  Your old macro assignment will be
  2342.     replaced with the new one.
  2343.  
  2344.     ┌─────────────────────────────────┐
  2345.     │ QEdit Tip:                      │
  2346.     │   Be aware of modes, especially │
  2347.     │   Insert mode, when recording   │
  2348.     │   and using macros.  Macros     │
  2349.     │   recorded with Insert mode ON  │
  2350.     │   and then used with Insert mode│
  2351.     │   OFF (and vice-versa) may      │
  2352.     │   behave very strangely.        │
  2353.     └─────────────────────────────────┘
  2354.  
  2355.  
  2356.     Saving and Reloading Macros
  2357.  
  2358.     Normally, macros created using this process are lost once the editor
  2359.     is terminated.  QEdit, however, provides an easy method of saving
  2360.     your macros so that they may be reloaded for use in any future
  2361.     editing session.
  2362.  
  2363.     Macros can be saved in a binary disk file.  You specify the name of
  2364.     this file.  Once macros have been created, enter the MacroWrite
  2365.     <Esc><M><W> command.  QEdit will prompt with:
  2366.  
  2367.     ┌─────────────────────────────────────────────────────────────────┐
  2368.     │Macro file to write: <Esc = abort>                               │
  2369.     │                                                                 │
  2370.     └─────────────────────────────────────────────────────────────────┘
  2371.  
  2372.     Enter the name of the file to contain your macros.  The macros will
  2373.     be saved under the given filename.  You may notice that this file
  2374.     now appears in the current DOS directory.  Macros assigned to the
  2375.     scrap area cannot be saved.
  2376.  
  2377.     In a future editing session, if you wish to reuse your previously
  2378.     defined macros, you need only reload the macro file.  To do this
  2379.     enter the MacroRead <Esc><M><R> command.  QEdit will prompt with:
  2380.  
  2381.     ┌─────────────────────────────────────────────────────────────────┐
  2382.     │Macro file to read: <Esc = abort>                                │
  2383.     │                                                                 │
  2384.     └─────────────────────────────────────────────────────────────────┘
  2385.  
  2386.     Enter the name of the previously saved macro file.  Your macros will
  2387.     be reloaded.  You may then use them in the same manner as before.
  2388.  
  2389.     The QEdit configuration program provides an alternate method of
  2390.     creating macros.  Refer to the "Keyboard Configuration" section of
  2391.     Chapter 2 for more information.
  2392.  
  2393.                                1-34
  2394.  
  2395.  
  2396.     Example of a Macro
  2397.  
  2398.     To create a macro which will insert a formfeed character (ASCII 12)
  2399.     at column one of the current cursor line, do the following:
  2400.  
  2401.     1. Position the cursor in the text where you would like to insert
  2402.        the formfeed character.
  2403.  
  2404.     2. Enter MacroRecord <Ctrl M>.
  2405.  
  2406.     3. Press <Alt F1> to assign the macro to this key.
  2407.  
  2408.     4. Press the following series of keys:
  2409.            <Home>     (for the BegLine command)
  2410.            <Ctrl P>   (for the Literal command)
  2411.            <Ctrl L>   (a formfeed character)
  2412.  
  2413.     5. Enter MacroRecord <Ctrl M>.  The macro is now created and
  2414.        assigned to the <Alt F1> key.
  2415.  
  2416.     Now, whenever you enter <Alt F1>, the cursor will be moved to column
  2417.     one and a formfeed character will be inserted, just as if you had
  2418.     typed it in from the keyboard.
  2419.  
  2420.  
  2421.     Printing
  2422.     ─────────────────────────────────────────────────────────────────────────
  2423.  
  2424.     QEdit allows you to print either your entire current file or a
  2425.     portion of the current file.
  2426.  
  2427.     To print the entire current file, simply enter the PrintAll
  2428.     <Alt P><A> command.  The entire current file will be printed.
  2429.  
  2430.     To print a portion of the current file, first mark the portion of
  2431.     the file to be printed using the Block marking commands.  (Refer to
  2432.     the "Block Commands" section in this chapter.)  Next, enter the
  2433.     PrintBlock <Alt P><B> command.  Only the marked Block portion of the
  2434.     file will be printed.
  2435.  
  2436.                                1-35
  2437.  
  2438.  
  2439.     Print Formatting
  2440.  
  2441.     Two commands are provided for setting the left margin and the page
  2442.     size.  (The left margin and page size may also be specified using
  2443.     the configuration program.  Refer to the "Printer Options" section
  2444.     of Chapter 2 for more information.)
  2445.  
  2446.     ■ SetPrintLeftMargin <Alt P><L>
  2447.       This command specifies the number of blank spaces to be used as a
  2448.       left margin. QEdit will prompt with:
  2449.  
  2450.       ┌──────────────────────────────────────────┐
  2451.       │Printer left margin [0..80]: <Esc = Abort>│
  2452.       │0                                         │
  2453.       └──────────────────────────────────────────┘
  2454.  
  2455.       Enter the left margin length from zero to 80.
  2456.  
  2457.     ■ SetPrintPageSize <Alt P><P>
  2458.       This command specifies the the number of lines to be printed on
  2459.       each page. QEdit will prompt with:
  2460.  
  2461.       ┌─────────────────────────────────────────┐
  2462.       │Printer page size [0..400]: <Esc = Abort>│
  2463.       │0                                        │
  2464.       └─────────────────────────────────────────┘
  2465.  
  2466.       Enter a page size from zero to 400.  A zero will instruct QEdit to
  2467.       print continuously without page breaks.
  2468.  
  2469.  
  2470.     Formfeeds
  2471.  
  2472.     QEdit will automatically send a formfeed character (ASCII 12) to the
  2473.     printer at the end of each page.  A page is determined by the page
  2474.     size as explained in the section above.
  2475.  
  2476.     At times you may find it desirable to insert formfeed characters
  2477.     directly into your text.  For example, you want the page size for
  2478.     your text to be 55 lines, which you have set using the
  2479.     SetPrintPageSize command, but there is a 15-line table in the text
  2480.     that should appear on a page by itself.  To accomplish this, simply
  2481.     insert formfeed characters immediately before and after the table.
  2482.  
  2483.     To insert a formfeed character in the text, enter the Literal
  2484.     <Ctrl P> command followed by a formfeed <Ctrl L> character. If you
  2485.     need to insert formfeed characters into your text repeatedly, you
  2486.     may want to use a macro.  An example of a macro to insert formfeed
  2487.     characters can be found in the "Macros" section in this chapter.
  2488.  
  2489.     It is also possible, from within QEdit, to send a formfeed character
  2490.     to the printer, causing the printer to eject a page.  To do this,
  2491.     simply enter the PrintEject <Alt P><F> command.
  2492.  
  2493.                                1-36
  2494.  
  2495.  
  2496.     The Shell and Dos commands
  2497.     ─────────────────────────────────────────────────────────────────────────
  2498.  
  2499.     (For the following discussion, "Dos" is a QEdit command, while "DOS"
  2500.     refers to the computer's operating system.)
  2501.  
  2502.     QEdit provides two very helpful commands that allow you to interact
  2503.     with DOS from within the editor.  The commands, Shell and Dos, allow
  2504.     you to perform most functions that you would normally execute from
  2505.     the DOS command line, then return you to your original position in
  2506.     the editor.
  2507.  
  2508.     ■ Shell <F9>
  2509.       This command should be used when executing multiple DOS commands.
  2510.       Upon entering the Shell command, control will be passed to DOS.
  2511.       The DOS prompt will appear on the screen, just as if no other
  2512.       programs were running.  You may now enter most DOS commands. (Some
  2513.       exceptions are noted below.)  Once you have entered all the
  2514.       desired DOS commands, simply type "exit <Enter>" and control will
  2515.       be passed back to QEdit.  You will be positioned in the file
  2516.       exactly where you were when the Shell command was entered.
  2517.  
  2518.     ■ Dos <Alt F9>
  2519.       This command should be used when executing a single DOS command.
  2520.       Upon entering this command, QEdit will prompt with:
  2521.  
  2522.       ┌───────────────────────────────────────────────────────────────┐
  2523.       │Execute what: <Esc = Abort>                                    │
  2524.       │                                                               │
  2525.       └───────────────────────────────────────────────────────────────┘
  2526.  
  2527.       You may now enter almost any DOS command.  (Some exceptions are
  2528.       noted below.)  Once the DOS command has completed, pressing any
  2529.       key will pass control back to QEdit.
  2530.  
  2531.     You should not execute any TSR programs (programs that terminate but
  2532.     remain resident in your computer) from the Shell or Dos commands.
  2533.     For example, the DOS PRINT and GRAPHICS commands are TSR programs.
  2534.  
  2535.     If you mistakenly execute a TSR program from QEdit's Shell or Dos
  2536.     command, the computer's memory allocation scheme will probably
  2537.     become fragmented, and as a result, QEdit's available memory may
  2538.     become severely limited.  You should save your files, terminate
  2539.     QEdit, and then reboot the computer.
  2540.  
  2541.                                1-37
  2542.  
  2543.  
  2544.     Word Processing Commands
  2545.     ─────────────────────────────────────────────────────────────────────────
  2546.  
  2547.     QEdit has all the features you need to do basic word processing.  In
  2548.     addition to the commands which enable you to view and edit your text
  2549.     (discussed in previous sections), QEdit provides word-wrapping and
  2550.     paragraph reformatting capabilities.
  2551.  
  2552.  
  2553.     ■ The right margin
  2554.       To benefit from the word-wrap and paragraph reformatting features
  2555.       of QEdit, an appropriate right margin must first be set.  The
  2556.       default setting is column 60.  This may be changed using the
  2557.       configuration program.  (Refer to the "General Options" section of
  2558.       Chapter 2 for instructions on how to change the right margin
  2559.       setting.)  This value of the right margin will be used each time
  2560.       the editor is initiated.
  2561.  
  2562.       QEdit provides the ability to change the right margin setting
  2563.       temporarily while the editor is running without affecting the
  2564.       permanent setting.  To change the right margin setting
  2565.       temporarily, enter the SetRmargin <Ctrl OR> command.  QEdit will
  2566.       prompt with:
  2567.  
  2568.       ┌────────────────────────────────────┐
  2569.       │right margin [1..300]: <Esc = abort>│
  2570.       │60                                  │
  2571.       └────────────────────────────────────┘
  2572.  
  2573.       Enter the desired column number for the right margin.  The new
  2574.       setting will be in effect until the SetRmargin command is entered
  2575.       again or the next time the editor is initiated.  WordWrap mode is
  2576.       automatically switched ON whenever the right margin is set using
  2577.       this command.
  2578.  
  2579.     ■ WordWrap
  2580.       WordWrap is a QEdit mode which can be switched ON and OFF using
  2581.       the ToggleWordwrap <Ctrl OW> command.  When switched ON, this mode
  2582.       will cause the cursor to advance automatically to the next line
  2583.       when text is being entered.
  2584.  
  2585.       The cursor will advance to the next line based on the right
  2586.       margin, which is set using the SetRmargin <Ctrl OR> command.  Once
  2587.       the cursor reaches the right margin and a non-blank character is
  2588.       typed, the cursor, along with the word (i.e., any continuous
  2589.       string of non-blank characters) currently being typed, will be
  2590.       advanced to the next line.
  2591.  
  2592.       The cursor will not advance to the next line if the current line
  2593.       does not contain at least one space.
  2594.  
  2595.                                1-38
  2596.  
  2597.  
  2598.     ■ Paragraph Reformatting
  2599.       The WrapPara <Alt B> command will reformat text from the current
  2600.       cursor position to the next blank line or the end of the file.
  2601.  
  2602.       The right-hand side of the text will be reformatted based on the
  2603.       right margin.  The right margin is set using the SetRmargin
  2604.       <Ctrl OR> command.
  2605.  
  2606.       The left-hand side of the text will be reformatted based on
  2607.       AutoIndent mode.  If AutoIndent mode is switched OFF, the left
  2608.       margin will be column one.  If AutoIndent mode is switched ON, the
  2609.       first non-blank character on the line immediately AFTER the cursor
  2610.       line will be used for the left margin.  Using the line AFTER the
  2611.       cursor line allows for special indentation for the first line of a
  2612.       paragraph.
  2613.  
  2614.  
  2615.     Modes
  2616.     ─────────────────────────────────────────────────────────────────────────
  2617.  
  2618.     QEdit uses modes to affect the operation of the editor.  In general,
  2619.     a QEdit mode is a state during which certain commands or keystrokes
  2620.     behave differently.  Following is an explanation of all the QEdit
  2621.     modes.
  2622.  
  2623.     ■ Insert mode
  2624.       Insert mode can be switched ON and OFF by pressing the <Ins> key.
  2625.       When Insert mode is ON, an "I" will appear on the Status Line.
  2626.       The following table describes the commands and keystrokes which
  2627.       are affected by Insert mode.
  2628.  
  2629.  
  2630.       Command/
  2631.       Keystroke       Insert ON                     Insert OFF
  2632.       ────────────    ──────────────────────        ──────────────────────
  2633.       Characters,     Shift text to right           Overwrite existing
  2634.       Space           of cursor, one column         text.
  2635.                       to the right.
  2636.  
  2637.       Backspace       Deletes character/word        Deletes character/word
  2638.                       to left of cursor.            to left of cursor.
  2639.                       Text to right of cursor       Text to right of cursor
  2640.                       shifts left one column.       does not shift.
  2641.  
  2642.       Return          Splits line at cursor         Does not split line.
  2643.                       position.  Cursor moves       Cursor moves to next
  2644.                       to next line.                 line.
  2645.  
  2646.       TabLt,          Tabs cursor and shifts        Tabs cursor only.
  2647.       TabRt           text same number of
  2648.                       positions.
  2649.  
  2650.                                1-39
  2651.  
  2652.  
  2653.     ■ AutoIndent mode
  2654.       AutoIndent mode is switched ON and OFF using the ToggleIndent
  2655.       <Ctrl QI> command.  This mode, when ON, positions the cursor at
  2656.       the current left margin (This is not the same as the print left
  2657.       margin.) whenever the <Enter> key is pressed.  The current left
  2658.       margin is determined by the first non-blank character on the
  2659.       immediately preceding line.  The following table describes the
  2660.       commands and keystrokes which are affected by AutoIndent mode.
  2661.  
  2662.  
  2663.       Command/
  2664.       Keystroke       AutoIndent ON                 AutoIndent OFF
  2665.       ────────────    ──────────────────────        ──────────────────────
  2666.  
  2667.       Return         Cursor positioned below        Cursor positioned at
  2668.                      first non-blank character      column one.
  2669.                      of previous line.
  2670.  
  2671.       WrapPara       When reformatting, the left    A left margin of zero is
  2672.                      margin is determined from      used when reformatting.
  2673.                      the first non-blank
  2674.                      character on the line
  2675.                      immediately following the
  2676.                      cursor line.
  2677.  
  2678.  
  2679.     ■ C mode
  2680.       This mode is specifically for "C" language programming.  It is
  2681.       switched ON and OFF using the configuration program.  (Refer to
  2682.       the "General Options" section of Chapter 2 for information on
  2683.       switching C mode ON and OFF.)  C mode is only in effect when
  2684.       AutoIndent mode is also ON.
  2685.  
  2686.       C Mode, when switched ON, affects files with a ".h" or ".c" file
  2687.       extension.  When the current cursor line contains a "{" and the
  2688.       <Enter> key is pressed, QEdit issues a normal Return followed by a
  2689.       TabRt command.  Additionally, when a "}" character is entered,
  2690.       QEdit first issues a TabLt command and then enters the "}"
  2691.       character.
  2692.  
  2693.  
  2694.     ■ WordWrap mode
  2695.       WordWrap mode is switched ON and OFF using the ToggleWordwrap
  2696.       <Ctrl OW> command.  When switched ON, this mode will cause the
  2697.       cursor to advance to the next line automatically when text is
  2698.       being entered.
  2699.  
  2700.       The cursor will advance to the next line based on the right
  2701.       margin, which is set using the SetRmargin <Ctrl OR> command. Once
  2702.       the cursor reaches the right margin and a non-blank character is
  2703.       typed, the cursor, along with the word (i.e., any continuous
  2704.       string of non-blank characters) currently being typed, will be
  2705.       advanced to the next line.
  2706.  
  2707.       The cursor will not advance to the next line if the current line
  2708.       does not contain at least one space.
  2709.  
  2710.                                1-40
  2711.  
  2712.  
  2713.     ■ BackUp mode
  2714.       BackUp mode is switched ON and OFF using the ToggleBakups
  2715.       <Esc><O><B> command.  When BackUp Mode is switched ON, QEdit will
  2716.       create a backup copy (using the .bak file extension) for any file
  2717.       that is edited and saved.  The backup copy of the file is an image
  2718.       of the file before it was last edited and saved.  When BackUp mode
  2719.       is OFF, no backup files will be created.
  2720.  
  2721.  
  2722.     ■ MacroRecord mode
  2723.       MacroRecord mode is switched ON and OFF using the MacroRecord
  2724.       <Ctrl M> command.  This mode, when ON, records and assigns a
  2725.       series of commands and keystrokes to a designated key (or scrap
  2726.       area).  This creates a macro.  For a complete explanation of
  2727.       macros and their use, refer to the "Macros" section in this
  2728.       chapter.
  2729.  
  2730.  
  2731.     ■ EnterMatching mode
  2732.       EnterMatching mode is switched ON and OFF using the
  2733.       ToggleEnterMatching <Esc><O><E> command.  If switched ON, QEdit
  2734.       will automatically insert into the text a corresponding ), ], or "
  2735.       character each time a (, [, or " character, respectively, is
  2736.       entered.
  2737.  
  2738.  
  2739.     ■ Box Drawing mode
  2740.       Box Drawing mode is switched ON and OFF using the ToggleBoxDraw
  2741.       <Shift F1> command.  If switched ON, the cursor movement keys (up,
  2742.       down, right, left) can be used to "draw" lines in the text.  This
  2743.       can be very useful for creating charts and tables.  All of the
  2744.       diagrams found in this manual were created using Box Drawing.
  2745.  
  2746.  
  2747.     ■ Smart Tabs mode
  2748.       Smart Tabs mode is switched ON and OFF using the ToggleSmartTabs
  2749.       <Ctrl QT> command.  If switched ON, the TabRt and TabLt commands
  2750.       will place the cursor beneath the first character of the next (or
  2751.       previous) word on the line immediately above the current cursor
  2752.       line.  If the line immediately above the cursor line is blank,
  2753.       then the cursor will not move.
  2754.  
  2755.       Smart Tabs mode should NOT be used in conjunction with C mode.
  2756.  
  2757.  
  2758.     ■ Physical Tab Expansion mode
  2759.       Physical Tab Expansion mode is switched ON and OFF using the
  2760.       ToggleTabsExpand <Alt V> command.  If switched ON, physical tab
  2761.       characters (ASCII 9's) found in a file will be expanded into
  2762.       spaces according to the Physical Tab Width set in the
  2763.       configuration program.  If switched OFF, physical tabs will be
  2764.       displayed on the screen and a physical tab character will be
  2765.       placed in the text each time the TabRt command is entered.
  2766.  
  2767.                                1-41
  2768.  
  2769.     ┌─────────────────────────────────┐
  2770.     │ QEdit Tip:                      │
  2771.     │   In general, Physical Tab      │
  2772.     │   Expansion mode should always  │
  2773.     │   be set ON.  You would only    │
  2774.     │   want to set it OFF if you were│
  2775.     │   editing binary or data files  │
  2776.     │   that contain or require       │
  2777.     │   physical tabs.                │
  2778.     └─────────────────────────────────┘
  2779.  
  2780.     ■ Tabs Out mode
  2781.       Tabs Out mode is switched ON and OFF using the ToggleTabsOut
  2782.       <Alt I> command.  If switched ON, continuous spaces in a line of
  2783.       text will be replaced with physical tabs (ASCII 9's) according to
  2784.       the Physical Tab Width set in the configuration program.  Only
  2785.       spaces in edited lines are replaced with physical tabs. Spaces
  2786.       falling between single or double quotes will not be replaced.
  2787.  
  2788.                                1-42
  2789.  
  2790.  
  2791.     Chapter 2. Customizing QEdit
  2792.     =========================================================================
  2793.  
  2794.     QEdit provides a configuration capability which allows the User to
  2795.     customize the editor to suit individual preferences.  There are a
  2796.     wide range of options which may be customized including key
  2797.     assignments, color, tab settings, and printer options.
  2798.  
  2799.     Of course, customizing QEdit is not a requirement.  If you like the
  2800.     editor exactly the way it is, it will not be necessary to use the
  2801.     configuration program.
  2802.  
  2803.     The configuration program is QCONFIG.EXE and is included on the
  2804.     distribution diskette, along with the other QEdit software. The
  2805.     configuration program customizes QEdit by actually modifying the
  2806.     editor program itself - Q.EXE.
  2807.  
  2808.     ┌─────────────────────────────────┐
  2809.     │ QEdit Tip:                      │
  2810.     │   Before running the            │
  2811.     │   configuration program, make   │
  2812.     │   a backup copy of the original │
  2813.     │   QEdit distribution disk.      │
  2814.     └─────────────────────────────────┘
  2815.  
  2816.  
  2817.     Initiating the Configuration Program
  2818.     ─────────────────────────────────────────────────────────────────────────
  2819.  
  2820.     To initiate the configuration program, type "qconfig <Enter>" from
  2821.     the DOS command line.  The program will request the name of the
  2822.     editor program to customize with the prompt:
  2823.  
  2824.     ┌────────────────────────────────────────────────────────────────┐
  2825.     │   Enter program name to config, <CR> for Q.EXE :               │
  2826.     └────────────────────────────────────────────────────────────────┘
  2827.  
  2828.     Simply press <Enter>, unless you have previously renamed the editor
  2829.     or if the editor is located in another directory.
  2830.  
  2831.     If you have renamed the editor, enter the appropriate filename and
  2832.     press <Enter>.  If the editor is located in another directory, enter
  2833.     the full pathname and press <Enter>.
  2834.  
  2835.     The program will then request an optional new name for the
  2836.     customized editor with the prompt:
  2837.  
  2838.     ┌────────────────────────────────────────────────────────────────┐
  2839.     │   Enter new name for Q.EXE, <CR> for Q.EXE :                   │
  2840.     └────────────────────────────────────────────────────────────────┘
  2841.  
  2842.     If you wish to name the newly customized program something besides
  2843.     Q.EXE, enter the new filename and press <Enter>.  Otherwise, simply
  2844.     press <Enter>.
  2845.  
  2846.     If the file to be customized could not be located on disk, this
  2847.     error message will be displayed:
  2848.  
  2849.     ┌────────────────────────────────────────────────────────────────┐
  2850.     │FATAL ERROR: Q.EXE not found                                    │
  2851.     └────────────────────────────────────────────────────────────────┘
  2852.  
  2853.                                2-2
  2854.  
  2855.     Check the editor's filename and/or path for accuracy.
  2856.  
  2857.     If the version numbers of the editor and the configuration program
  2858.     are not the same, this error message will be displayed:
  2859.  
  2860.     ┌────────────────────────────────────────────────────────────────┐
  2861.     │FATAL ERROR: patch area not found                               │
  2862.     └────────────────────────────────────────────────────────────────┘
  2863.  
  2864.     Try reloading the QEdit software from the distribution disk (i.e.,
  2865.     Q.EXE and QCONFIG.EXE).
  2866.  
  2867.  
  2868.     The Configuration Menu
  2869.     ─────────────────────────────────────────────────────────────────────────
  2870.  
  2871.     The configuration program will display a menu from which to select
  2872.     the desired functions for customization.
  2873.  
  2874.     Following is a brief explanation of these menu items.  They will
  2875.     each be discussed in detail in this chapter.
  2876.  
  2877.     A)dvanced options
  2878.         Contains a variety of configurable options, including those
  2879.         related to video display, DOS memory, and editor menus.
  2880.  
  2881.     C)olors/screen
  2882.         Allows you to change colors of various editor displays when
  2883.         using a color monitor.
  2884.  
  2885.     G)eneral options
  2886.         A miscellaneous category of options.
  2887.  
  2888.     H)elp install
  2889.         Allows you to create your own Help Screen.
  2890.  
  2891.                                2-3
  2892.  
  2893.     K)eys
  2894.         Allows you to reassign editor commands to different keys.
  2895.  
  2896.     P)rinter options
  2897.         Allows you to set options for printing text, such as page size.
  2898.  
  2899.     Q)uit
  2900.         Terminates the program.  You will first be prompted to save or
  2901.         not to save changes.
  2902.  
  2903.     S)ave changes and quit
  2904.         After you have made all of the desired changes, press <S> to
  2905.         save the changes and terminate the program.
  2906.  
  2907.     T)ab settings
  2908.         Allows you to set the physical and cursor tab widths.
  2909.  
  2910.  
  2911.     Choose the category that you wish to customize by pressing the first
  2912.     letter of the corresponding menu item.  You will be prompted for a
  2913.     response to each option within the category.  Each configuration
  2914.     option will be displayed along with its current value.  (The Keys
  2915.     and Help install categories, however, work a little differently in
  2916.     that they request a filename.)
  2917.  
  2918.     For each option displayed, you may enter a new value. If you do not
  2919.     wish to change the current value, simply press <Enter>.  After you
  2920.     have reviewed all options in a category, you will be returned to the
  2921.     main menu where you may select another category.
  2922.  
  2923.     Once you have completed customizing, you may save all the changes
  2924.     you have made by pressing <S> at the main menu prompt.  Your changes
  2925.     will be made permanent (that is, effective the next time you execute
  2926.     the editor), and the configuration program will be terminated.
  2927.  
  2928.     If you decide that you do not want to save your changes, press <Q>.
  2929.     The prompt "Save Changes (Y/N)?" will be displayed.  Simply press
  2930.     <N>. No changes will be saved and the configuration program will be
  2931.     terminated.
  2932.  
  2933.                                2-4
  2934.  
  2935.  
  2936.     Advanced Options
  2937.     ─────────────────────────────────────────────────────────────────────────
  2938.  
  2939.     This section contains a list of the Advanced Options which can be
  2940.     customized using the configuration program. The configuration
  2941.     program prompt, the default value, and a description are given for
  2942.     each option.
  2943.  
  2944.     ■ Test for presence of EGA or VGA adapters (Y/N)? [Y] :
  2945.         For Concurrent PC-DOS (a Digital Research version of DOS) users
  2946.         only, this option should be set to <N>.
  2947.  
  2948.     ■ Test for presence of enhanced keyboard (Y/N)? [N] :
  2949.         If your system has an enhanced (101 key) keyboard then set this
  2950.         option to <Y> and QEdit will recognize the additional keys such
  2951.         as F11, F12, and grey cursor keys.
  2952.  
  2953.     ┌─────────────────────────────────┐
  2954.     │ QEdit Tip:                      │
  2955.     │   Many TSR's, including mouse   │
  2956.     │   drivers, do not properly      │
  2957.     │   recognize the enhanced        │
  2958.     │   keyboard.  If you are using   │
  2959.     │   a TSR and it is not working   │
  2960.     │   with QEdit, try setting this  │
  2961.     │   option to <N>.                │
  2962.     └─────────────────────────────────┘
  2963.  
  2964.     ■ Should QEdit change the cursor size (Y/N)? [Y] :
  2965.         By default, QEdit uses a small cursor when Insert mode is OFF
  2966.         and a medium cursor when Insert mode is ON.  Selecting <N> will
  2967.         tell QEdit not to change the cursor size.
  2968.  
  2969.     ■ Fast screen updating with "flicker" OK (CGA's only)(Y/N)? [N] :
  2970.         If QEdit determines that your system has a Color/Graphics
  2971.         Adapter card (CGA), the editor will not write to the screen at
  2972.         full speed in order to avoid "snow" (a sparkling appearance on
  2973.         the screen that results from updating the screen too quickly).
  2974.  
  2975.         If your system has a CGA card and the screen updates too slowly,
  2976.         try setting this option to <Y>.
  2977.  
  2978.     ■ Number of rows on physical screen [25..100] [25] :
  2979.         For Micro Display Systems (MDS) users ONLY.  If your Genius
  2980.         Video System supports more than a 25-line screen, then specify
  2981.         that number here.
  2982.  
  2983.     ■ Do you want the Return command to split lines in insert mode
  2984.       (Y/N)? [Y] :
  2985.         Normally, the Return command splits the current line at the
  2986.         cursor when pressed in Insert mode. This means that the part of
  2987.         the line following the cursor will be inserted on a new line. If
  2988.         Insert mode is OFF, the Return command will simply place the
  2989.         cursor at the beginning of the next line.
  2990.  
  2991.                                2-5
  2992.  
  2993.         If you select <N> for this option, the Return command will
  2994.         always act as if Insert mode is OFF.  Return will move the
  2995.         cursor to the beginning of the next line with no effect on the
  2996.         text.
  2997.  
  2998.     ■ Should Cut and Copy use current line if no block marked(Y/N)? [N] :
  2999.         If a block is not marked, and you execute the Cut or Copy
  3000.         command, the current cursor line will be affected if you enter
  3001.         <Y> for this option.
  3002.  
  3003.     ■ Amount of memory to reserve from DOS (in paragraphs)
  3004.       [0,8..32767]  [0] :
  3005.         COMMAND.COM normally occupies the high end of DOS memory. If a
  3006.         program uses all available DOS memory, then COMMAND.COM can be
  3007.         overlayed and will have to be reloaded when the application is
  3008.         finished.  This really is not a problem on a hard disk system,
  3009.         as the reload takes a very short time.  On a diskette based
  3010.         system, the delay can be somewhat annoying.  Specifying a value
  3011.         of 1400 should keep COMMAND.COM from having to be reloaded on
  3012.         any DOS version through 3.3.  Please note that this will deny
  3013.         QEdit of an additional 22k of memory.
  3014.  
  3015.     ■ Code generated by ALT numeric keypad  [0] :
  3016.         The <Alt> numeric keypad can be used to enter just about any of
  3017.         the characters in the IBM PC character set.  Characters are
  3018.         entered by holding down the <Alt> key and pressing the decimal
  3019.         number(s) that represents that character.  On IBM PC's this
  3020.         action returns a scan code of 0.  A small number of compatible
  3021.         PC's return a different scan code.  If your PC returns a
  3022.         different scan code for the <Alt> numeric keypad, enter it here.
  3023.  
  3024.     ■ Do you want the ESCAPE command to invoke the menus (Y/N)? [Y] :
  3025.         By default, the Escape command displays the "Pop-Down" menus,
  3026.         when executed outside of the menus or any QEdit prompts.  If you
  3027.         do NOT want the Escape command to do this, select <N> for this
  3028.         option.
  3029.  
  3030.     ■ Do you want to invoke the editor at a specified line number
  3031.       (Y/N)? [N] :
  3032.         If you choose <Y>, QEdit will position the cursor at a specified
  3033.         line number in a file when the file is loaded into the editor.
  3034.         For example, to load "file1" at line number 125, simply type
  3035.         "q file1 125 <Enter>" from the DOS command line or "file1 125"
  3036.         at any QEdit "file to edit" prompt.
  3037.  
  3038.                                2-6
  3039.  
  3040.  
  3041.     Colors/Screen Options
  3042.     ─────────────────────────────────────────────────────────────────────────
  3043.  
  3044.     This section contains a list of the Screen and Screen Color Options
  3045.     which can be customized using the configuration program. The
  3046.     configuration program prompt, the default value, and a description
  3047.     are given for each option.
  3048.  
  3049.     ■ Statusline position: "T" for top, "B" for bottom  [T] :
  3050.         The Status Line may be positioned at the top or at the bottom
  3051.         line of the screen.
  3052.  
  3053.     ■ Statusline fill character [ ] :
  3054.         This character is used to "break up" the information on the
  3055.         editor's Status Line.  The default is a space.  For example, if
  3056.         the dash character is specified then the Status Line would look
  3057.         like this:
  3058.  
  3059.     ┌──────────────────────────────────────────────────────────────────────┐
  3060.     │L 15-- C 15---IAW-R-B--411K-----*c:\qedit\qedit.doc-------------------│
  3061.     └──────────────────────────────────────────────────────────────────────┘
  3062.  
  3063.     ■ Do you want the display "boxed" (Y/N)? [N] :
  3064.         The editing screen may be completely enclosed in a box.
  3065.  
  3066.     ■ Do you want the original screen restored upon termination (Y/N)? [Y] :
  3067.         QEdit can optionally restore the original screen upon exiting
  3068.         the program.  Be aware that selecting this option takes up 4k of
  3069.         memory.  But it is very handy after long uninterrupted editing
  3070.         sessions to see what you were doing before you started.
  3071.  
  3072.     ■ Do you want "snow" checking (Y/N)? [Y] :
  3073.         If QEdit determines that your system has a Color/Graphics
  3074.         Adapter card (CGA), the editor will not write to the screen at
  3075.         full speed in order to avoid "snow" (a sparkling appearance on
  3076.         the screen that results from updating the screen too quickly).
  3077.  
  3078.         If you have a COMPAQ, ZENITH, or other color adapter that allows
  3079.         full speed screen updating without "snow", then set this option
  3080.         to <N>.
  3081.  
  3082.         This option has no effect on monochrome and true EGA/VGA cards.
  3083.  
  3084.     ■ Number of columns to scroll horizontally for screen lt/rt
  3085.       commands [1..400] [1] :
  3086.         This is the number of columns that QEdit should scroll when you
  3087.         enter the ScreenLeft or ScreenRight commands.
  3088.  
  3089.                                2-7
  3090.  
  3091.  
  3092.     (illustration not available in disk manual)
  3093.  
  3094.     The chart above is for use with the following Screen Color Options.
  3095.     Enter a number, in response to each option, based on the color in
  3096.     which the number appears on the chart.
  3097.  
  3098.     If you have a monochrome screen, many of the values in the chart
  3099.     will appear to be the same color.  However, you will still have the
  3100.     options of normal, highlighted, underlined, and reverse video. If
  3101.     you have a color monitor you can take advantage of a wider array of
  3102.     options.
  3103.  
  3104.     ■ Blocked Text [112]:
  3105.         The color used for marked Blocks.
  3106.  
  3107.     ■ Error msgs [112]:
  3108.         The color used for warning and error messages.
  3109.  
  3110.     ■ Text Area [7]:
  3111.         The color used for normal text (the editing screen).
  3112.  
  3113.     ■ Status Line [9]:
  3114.         The color used for the Status Line.
  3115.  
  3116.     ■ Cursor Line [15]:
  3117.         The color used for the cursor line.  Reverts to normal when a
  3118.         block is marked.
  3119.  
  3120.     ■ Messages [15]:
  3121.         The color used for QEdit messages.
  3122.  
  3123.     ■ Hi-lited items [9]:
  3124.         The color used for "found" search strings when using the Find
  3125.         and FindReplace commands.
  3126.  
  3127.     ■ EOF line/indicator [15]:
  3128.         The color used for the "end of file" line.
  3129.  
  3130.                                2-8
  3131.  
  3132.     ■ Help screen [112]:
  3133.         The color used for the Help Screen.
  3134.  
  3135.     ■ Box borders [15]:
  3136.         The color used for box borders.
  3137.  
  3138.     ■ PopUp windows [15]:
  3139.         The color used for the background of the "Pop-Down" menus.
  3140.  
  3141.     ■ Menu items [15]:
  3142.         The color used for items within menus.
  3143.  
  3144.     ■ Selected Menu items [112]:
  3145.         The color used for selected items within menus.
  3146.  
  3147.  
  3148.     General Options
  3149.     ─────────────────────────────────────────────────────────────────────────
  3150.  
  3151.     This section contains a list of the General Options which can be
  3152.     customized using the configuration program.  The configuration
  3153.     program prompt, the default value, and a description are given for
  3154.     each option.
  3155.  
  3156.     ■ Do you want the DelCh command to join lines if at EOL (Y/N)? [Y] :
  3157.         If you want the DelCh command to be restricted so that it only
  3158.         works on the current line, then select <N> for this option.  If
  3159.         you select <Y>, the command will work across line breaks.  This
  3160.         means that if you issue DelCh at the end of the line, the
  3161.         following line will be joined to the end of the cursor line
  3162.         (just as if you had issued a JoinLine command).
  3163.  
  3164.     ■ Do you want the PQuit, Exit, and File commands to return to
  3165.       "EditFile" prompt (Y/N)? [Y] :
  3166.         If only 1 file is being edited, QEdit can either terminate or
  3167.         ask for another file to edit whenever the PQuit, Exit, or File
  3168.         commands are executed.  Enter <N> to terminate.
  3169.  
  3170.     ■ Do you want the editor to start in Wordwrap Mode (Y/N)? [N] :
  3171.         If you want WordWrap mode to be ON each time QEdit is executed,
  3172.         then set this option to <Y>.  Refer to the "Word Processing
  3173.         Commands" section of Chapter 1 for more information on WordWrap.
  3174.  
  3175.     ■ Default right margin for Wordwrap [1..512] [60] :
  3176.         This is the default right margin setting each time QEdit is
  3177.         executed.  Refer to the "Word Processing Commands" section of
  3178.         Chapter 1 for more information.
  3179.  
  3180.                                2-9
  3181.  
  3182.     ■ Do you want the editor to start in Insert Mode (Y/N)? [Y] :
  3183.         If you want Insert mode to be ON each time QEdit is executed,
  3184.         then set this option to <Y>.  Refer to the "Modes" section of
  3185.         Chapter 1 for more information on Insert mode.
  3186.  
  3187.     ■ Do you want the editor to start in Autoindent Mode (Y/N)? [Y] :
  3188.         If you want AutoIndent mode to be ON each time QEdit is
  3189.         executed, then set this option to <Y>.  Refer to the "Modes"
  3190.         section of Chapter 1 for more information on AutoIndent mode.
  3191.  
  3192.     ■ Load wildcarded filespecs from the command line (Y/N)? [Y] :
  3193.         When QEdit encounters a wildcarded file specification (* or ?)
  3194.         from the DOS command line, it will do one of two things
  3195.         depending on this option setting.  If you select <Y>, the editor
  3196.         will load every file that matches the wildcarded specification.
  3197.         (For example, if you entered "q *.doc", QEdit would load all
  3198.         files with the extension ".doc"). However, if you select <N>,
  3199.         QEdit will display a "Pop-Down" menu list of all the files which
  3200.         match the wildcarded specification.  You can then choose the
  3201.         file you want to edit by using the cursor keys and pressing
  3202.         <Enter>.
  3203.  
  3204.     ■ Load wildcarded filespecs from inside the editor (Y/N)? [N] :
  3205.         This option is similar to the previous one, except that it
  3206.         refers to the EditFile command rather than the DOS command line
  3207.         used at startup.  If you use a wildcard character with EditFile
  3208.         it will either load all matching files, or show you a list of
  3209.         matching files, depending on your choice for this option. Select
  3210.         <Y> to load all matching files and <N> to display a list of
  3211.         matching files.
  3212.  
  3213.     ■ Do you want the editor to start in "enter matching" mode (Y/N)? [N] :
  3214.         When ON, the double quote, parenthesis, and square bracket keys
  3215.         all automatically enter the matching character when the left
  3216.         character is entered.  For example, typing the '[' key
  3217.         automatically enters a ']' immediately following.
  3218.  
  3219.     ■ Use CMODE for .c and .h files (Y/N)? [Y] :
  3220.         C mode is included primarily for editing C Language programs.  C
  3221.         mode is only in effect when AutoIndent mode is also ON.  When C
  3222.         mode is active, <Enter> typed on a line containing a '{' does a
  3223.         normal return and then issues a TabRt command.  Subsequently,
  3224.         when a '}' is typed, a TabLt command is issued.
  3225.  
  3226.     ■ Default number of deleted lines to keep per file [0..300] [30] :
  3227.         QEdit saves a certain number of deleted lines and blocks, which
  3228.         can later be recalled using the UnKill command.  This option
  3229.         allows you to select the maximum number of lines QEdit can save
  3230.         for every edited file.
  3231.  
  3232.                                2-10
  3233.  
  3234.     ■ Remove trailing blanks from edited lines (Y/N)? [Y] :
  3235.         When you edit a line of text, QEdit can either remove trailing
  3236.         blanks from that line or leave it as is.  For most purposes, the
  3237.         remove option is preferable, as it will generally create smaller
  3238.         files.
  3239.  
  3240.     ■ Delete white space after words with DelRtWord command (Y/N)? [Y] :
  3241.         If you enter the DelRtWord command, it deletes the "word" to the
  3242.         right of the cursor.  This option causes DelRtWord to delete the
  3243.         blank space which follows the word as well.
  3244.  
  3245.     ■ Terminate files with a Control Z (Y/N)? [N] :
  3246.         MS/PC-DOS versions 2.0 thru 3.3 do NOT require an end of file
  3247.         terminator (the exact size of the file is stored in the
  3248.         directory).  However, some programs that were directly
  3249.         translated from their CP/M versions still require the Control Z
  3250.         end of file marker.  If you have one of these programs for which
  3251.         you are creating text files, you should select <Y> for this
  3252.         option.
  3253.  
  3254.     ■ Do you want "backups" of saved files (Y/N)? [Y] :
  3255.         Select <Y> if you want a backup file (an image of the file
  3256.         before you did any editing) with the .bak extension saved each
  3257.         time you save a file.
  3258.  
  3259.     ■ Prompt for filename on open window (Y/N)? [N] :
  3260.         If you enter the HorizontalWindow command, QEdit can either
  3261.         prompt you for the name of the file you want to load into the
  3262.         new window or load the next file in the ring into the new window
  3263.         (in the latter case, if only one file is being edited another
  3264.         window for the same file is opened).
  3265.  
  3266.         To have QEdit prompt you for a filename, select <Y>.  To have it
  3267.         load the next file in the ring, select <N>.
  3268.  
  3269.     ■ Close window when a file is quit (Y/N)? [Y] :
  3270.         If you enter any command which discards a file from the editor
  3271.         whenever more than one window is open, QEdit can either load the
  3272.         next file in the ring into that window or close that window.
  3273.  
  3274.         To have QEdit close the window, select <Y>.  To have it load the
  3275.         next file in the ring, select <N>.
  3276.  
  3277.     ■ Display End Of File marker (Y/N)? [Y] :
  3278.         QEdit can optionally display a line at the end of the file in
  3279.         the following format:
  3280.  
  3281.                    <*** End of File ***>
  3282.  
  3283.                                2-11
  3284.  
  3285.     ■ Insert line blocks ABOVE the cursor line (Y/N)? [N] :
  3286.         Line blocks can either be inserted (with the Paste, CopyBlock,
  3287.         or MoveBlock command) above or below the current cursor line.
  3288.  
  3289.     ■ Default Find options [IWB] [I]:
  3290.         Select the default search options when using the Find command.
  3291.         The options are:
  3292.  
  3293.         I - Ignore Case.  The Find command will ignore lower and upper
  3294.             case when searching for a matching string.
  3295.  
  3296.         W - Words Only.  The Find command will search for matching
  3297.             strings which are whole words only.  For example, with the
  3298.             "W" option on, searching for the string "not", QEdit would
  3299.             ignore strings such as "cannot", "notes", etc. and only
  3300.             identify occurrences of the string "not" delimited by
  3301.             spaces.
  3302.  
  3303.         B - Backwards Search.  This option causes the Find command to
  3304.             begin with the current cursor position and search backwards
  3305.             toward the beginning of the file.
  3306.  
  3307.         Note that even when these options are not selected as defaults,
  3308.         they can still be selected from within the editor whenever the
  3309.         Find command is executed.
  3310.  
  3311.     ■ Default FindReplace options [IWBN] [I]:
  3312.  
  3313.         Select the default search and replace options when using the
  3314.         FindReplace command.  The options are:
  3315.  
  3316.         I - Ignore Case.  The FindReplace command will ignore lower and
  3317.             upper case when searching for a matching string.
  3318.  
  3319.         W - Words Only.  The FindReplace command will search for
  3320.             matching strings which are whole words only.  For example,
  3321.             with the "W" option on, searching for the string "not",
  3322.             QEdit would ignore strings such as "cannot", "notes", etc.
  3323.             and only identify occurrences of the string "not" delimited
  3324.             by spaces.
  3325.  
  3326.         B - Backwards Search.  This option causes the FindReplace
  3327.             command to begin with the current cursor position and search
  3328.             backwards toward the beginning of the file.
  3329.  
  3330.         N - No Prompting.  The FindReplace command will not prompt when
  3331.             it identifies a matching string; instead, all occurrences of
  3332.             the search string will be replaced with the new string.
  3333.  
  3334.                                2-12
  3335.  
  3336.         Note that even when these options are not selected as defaults,
  3337.         they can still be selected from within the editor whenever the
  3338.         FindReplace command is executed.
  3339.  
  3340.     ■ Default file extension number 1 [.pas]:
  3341.  
  3342.     ■ Default file extension number 2 [.inc]:
  3343.  
  3344.     ■ Default file extension number 3 [.asm]:
  3345.  
  3346.     ■ Default file extension number 4 [.c]:
  3347.  
  3348.     ■ Default file extension number 5 [.h]:
  3349.  
  3350.     ■ Default file extension number 6 [.doc]:
  3351.  
  3352.         Six default file extensions are provided to save keystrokes each
  3353.         time a filename to edit is entered.  These file extensions are
  3354.         used whenever QEdit is executed with a filename from the command
  3355.         line or whenever the EditFile command is entered.
  3356.  
  3357.         When using QEdit, if the filename entered does not have a period
  3358.         (and does not include the DOS wildcard characters) and that file
  3359.         does NOT exist as named, QEdit appends the first default file
  3360.         extension to the name and tries to load that file.  If that file
  3361.         exists, then QEdit loads it for editing.  If it does not exist,
  3362.         QEdit will repeat the process with the other default file
  3363.         extensions.  If no files were found, then QEdit will create a
  3364.         new file as originally named.
  3365.  
  3366.  
  3367.     The Help Screen
  3368.     ─────────────────────────────────────────────────────────────────────────
  3369.  
  3370.     QEdit allows you to create a customized one page Help Screen, which
  3371.     may be displayed at any time from within the editor by entering the
  3372.     QuickHelp <F1> command.
  3373.  
  3374.     Of course, you may prefer to use the default Help Screen which is
  3375.     already loaded into QEdit.  In that case no action is required.
  3376.     However, if you want to design and use your own Help Screen, simply
  3377.     follow these steps:
  3378.  
  3379.     1. Create an 80 x 25 (80 columns by 25 lines) text file (you can use
  3380.        QEdit to create this file) and list all of the information that
  3381.        should appear on the screen when the QuickHelp command is
  3382.        entered.  We suggest that you list less frequently used commands
  3383.        in this file, while leaving out more familiar commands such as
  3384.        cursor movement and paging.
  3385.  
  3386.                                2-13
  3387.  
  3388.     2. Run QCONFIG.EXE and select option <H> from the menu.
  3389.  
  3390.     3. You will be prompted for the name of the Help file just created.
  3391.        Enter that name.
  3392.  
  3393.     That is all there is to it!  The next time you enter QuickHelp from
  3394.     within QEdit, your customized Help Screen will be displayed.
  3395.  
  3396.  
  3397.     Keyboard Configuration
  3398.     ─────────────────────────────────────────────────────────────────────────
  3399.  
  3400.     QEdit provides the extremely helpful capability of assigning editor
  3401.     commands (and strings of characters) to almost any key you prefer.
  3402.  
  3403.     This allows you to assign frequently used commands to keys which are
  3404.     most convenient for your use or you may wish to reassign commands
  3405.     completely to emulate another text editor or word processor with
  3406.     which you are already familiar.
  3407.  
  3408.     By taking a few minutes to review this section, your future text
  3409.     editing may become significantly smoother and more comfortable as a
  3410.     result of customizing your keyboard to suit your individual
  3411.     preferences.
  3412.  
  3413.  
  3414.     The Keyboard Definition File
  3415.  
  3416.     QEdit uses the Keyboard Definition file to customize the keyboard.
  3417.     This file contains a list of all the keys to which commands may be
  3418.     assigned.  Supplied with QEdit is a Keyboard Definition file called
  3419.     QCONFIG.DAT which contains the default settings for the keyboard.
  3420.     Other files are supplied which emulate certain common word
  3421.     processors.  WordStar command keys can be emulated using the
  3422.     WSKEY.DAT Keyboard Definition file.  Brief command keys can be
  3423.     emulated using the BRIEF.DAT Keyboard Definition file.
  3424.  
  3425.     The Keyboard Definition file consists of a list of configurable keys
  3426.     and the commands or macros which are assigned to them.  The
  3427.     configurable keys are on the left side of the file with the commands
  3428.     or macros assigned to the keys on the right.  Blank lines and lines
  3429.     starting with an asterisk "*" are ignored. The QCONFIG.DAT file, as
  3430.     well as Appendix B, contains a complete list of configurable keys.
  3431.  
  3432.     Control keys are specified with a "^".  For example:
  3433.  
  3434.         ^f1 or ^F1 specifies Control F1
  3435.         ^c  or ^C  specifies Control C
  3436.         ^PgUp      specifies Control PgUp
  3437.  
  3438.                                2-14
  3439.  
  3440.     Alternate keys are specified with a "@".  For example:
  3441.  
  3442.         @f1 or @F1 specifies Alt F1
  3443.         @c  or @C  specifies Alt C
  3444.         @PgUp      specifies Alt PgUp
  3445.  
  3446.     Shift keys are specified with a "#".  For example:
  3447.  
  3448.         #f1 or #F1 specifies Shift F1
  3449.  
  3450.     The format of a line in the Keyboard Definition file is simply the
  3451.     keystroke followed by the command.  For example:
  3452.  
  3453.         f1                      QuickHelp
  3454.         #f5                     MakeCtrofScreen
  3455.         @f2                     InsertLine
  3456.         cursorup                CursorUp
  3457.         ^cursorleft             WordLeft
  3458.         backspace               Backspace
  3459.         ^backspace              DelLtWord
  3460.         @a                      DropAnchor
  3461.         ^a                      WordLeft
  3462.  
  3463.     ┌─────────────────────────────────┐
  3464.     │ QEdit Tip:                      │
  3465.     │   The configuration program     │
  3466.     │   ignores the case of the       │
  3467.     │   command, as well as any       │
  3468.     │   underscores that may be       │
  3469.     │   embedded.  This means that    │
  3470.     │   InsertLine, insert_line, and  │
  3471.     │   Insert_Line all refer to the  │
  3472.     │   same command.                 │
  3473.     │                                 │
  3474.     │   Also, the order of the keys   │
  3475.     │   does not matter.  The         │
  3476.     │   configurable keys may be      │
  3477.     │   put in any order desired.     │
  3478.     └─────────────────────────────────┘
  3479.  
  3480.     There is also a provision for assigning commands to a "twokey". A
  3481.     twokey consists of two distinct keystrokes, such as <Ctrl B>
  3482.     immediately followed by <A>.  To assign a command to a twokey, enter
  3483.     both keystrokes of the twokey in the first column (keystroke column)
  3484.     separated by an underline.
  3485.  
  3486.     For example, to assign the Exit command to the twokey,
  3487.     <Ctrl F1> <F2>, enter the following into the Keyboard Definition
  3488.     file:
  3489.  
  3490.         ^f1_f2     Exit
  3491.  
  3492.                                2-15
  3493.  
  3494.     Through the use of macros, multiple commands and/or text may be
  3495.     assigned to any configurable key (Macros, however, cannot be
  3496.     assigned to twokeys).  To define a macro, specify MacroBegin as the
  3497.     first command, followed by any combination of text and QEdit
  3498.     commands, each separated by a space.  Text should be enclosed in
  3499.     single or double quotes.  The commands and/or text must all fit on
  3500.     one line, not exceeding 255 characters in length.
  3501.  
  3502.     Example:
  3503.  
  3504.         f1  MacroBegin EditFile 'help.dat' Return
  3505.  
  3506.     This macro would load the file 'help.dat'.  Note that the Return
  3507.     command is issued after the text.  This is required to terminate the
  3508.     QEdit prompt.
  3509.  
  3510.     Example:
  3511.  
  3512.         @t  MacroBegin GSave Dos 'tpc ' CurrentFilename Return
  3513.  
  3514.     Now, when you press <Alt T>, all changed files will be saved and the
  3515.     Turbo Pascal compiler will be invoked on the current file.
  3516.  
  3517.     Example (the following must appear on 1 line in the Keyboard
  3518.     Definition file):
  3519.  
  3520.         @f1     MacroBegin EditFile 'errors.lst' Return Quit Dos
  3521.                 'tcc ' CurrentFilename ' >errors.lst' Return Return
  3522.                 HorizontalWindow EditFile 'errors.lst' Return
  3523.  
  3524.     This macro will run the Turbo C compiler on the current file, saving
  3525.     the results to a file called "errors.lst", and loading that file
  3526.     into another window after the compile is finished.
  3527.  
  3528.     Additional examples can be found in Appendix D.  In general, any
  3529.     commonly used sequence of commands (or a useful, but complicated
  3530.     sequence of commands for that matter) is a good candidate for a
  3531.     macro.
  3532.  
  3533.  
  3534.     Creating a Keyboard Definition File
  3535.  
  3536.     To customize the keyboard using the default Keyboard Definition
  3537.     file, QCONFIG.DAT, no action is required.  QEdit is distributed with
  3538.     this Keyboard Definition file already loaded.
  3539.  
  3540.                                2-16
  3541.  
  3542.     To customize the keyboard using one of the supplied word processor
  3543.     emulation Keyboard Definition files, skip to step number 6 below.
  3544.  
  3545.     To create your own Keyboard Definition file, do the following:
  3546.  
  3547.     1. Load the file QCONFIG.DAT into QEdit (from the DOS command line
  3548.        type "q qconfig.dat <Enter>").
  3549.  
  3550.     2. Rename the file using the ChangeFilename command <Alt O>.
  3551.  
  3552.     3. Browse through the file using the Cursor Up and Down keys. Notice
  3553.        that the left side of the file contains a list of all
  3554.        configurable keys.  To the right of each key is the command or
  3555.        macro currently assigned to the key.  Some keys have no commands
  3556.        assigned.
  3557.  
  3558.     4. Change the commands assigned to the keys to suit your particular
  3559.        needs.  For more information on how to assign keys, refer to The
  3560.        Keyboard Definition file section above.
  3561.  
  3562.     5. Save the file and exit QEdit by pressing <Alt X>.
  3563.  
  3564.     6. Run QCONFIG.EXE and select option <K> from the menu.
  3565.  
  3566.     7. You will be prompted for the name of the Keyboard Definition
  3567.        file.  Enter the name of the Keyboard Definition file you wish to
  3568.        load.  If you are creating your own file, enter the new name
  3569.        chosen in step 2.
  3570.  
  3571.     8. Your key assignments will be incorporated into the editor
  3572.        program, Q.EXE.  The QCONFIG menu will again appear. Press <S> to
  3573.        save your changes and terminate the program.
  3574.  
  3575.     9. Run the editor to insure that your key assignments function as
  3576.        desired.
  3577.  
  3578.  
  3579.     Printer Options
  3580.     ─────────────────────────────────────────────────────────────────────────
  3581.  
  3582.     This section contains a list of the Printer Options which can be
  3583.     customized using the configuration program.  The configuration
  3584.     program prompt, the default value, and a description are given for
  3585.     each option.
  3586.  
  3587.     ■ Default left margin for printing [0..80] [0]:
  3588.         This is the number of spaces QEdit skips before printing each
  3589.         line. If you do not want QEdit to skip any spaces at the
  3590.         beginning of each line, select zero.
  3591.  
  3592.     ■ Default page size for printing [0..400] [0]:
  3593.         QEdit will send a formfeed character to the printer after
  3594.         printing this number of lines.  If you do NOT want QEdit to send
  3595.         formfeeds (continuous printing), select zero.
  3596.  
  3597.                                2-17
  3598.  
  3599.     ■ Add formfeed after printing (Y/N)? [Y] :
  3600.         Should QEdit send a formfeed when printing is complete?  If you
  3601.         select <Y>, your forms should be correctly lined up in
  3602.         preparation for the next printing operation.
  3603.  
  3604.  
  3605.     Tab Settings
  3606.     ─────────────────────────────────────────────────────────────────────────
  3607.  
  3608.     This section contains a list of all Tab Setting Options which can be
  3609.     customized using the configuration program.  The configuration
  3610.     program prompt, the default value, and a description are given for
  3611.     each option.
  3612.  
  3613.  
  3614.    ■ Do you want the editor to start in Physical Tab Expansion Mode (Y/N)? [Y] :
  3615.         If you want Physical Tab Expansion mode to be ON each time QEdit
  3616.         is executed, then set this option to <Y>.  Refer to the "Modes"
  3617.         section of Chapter 1 for more information on Physical Tab
  3618.         Expansion.
  3619.  
  3620.     ■ Do you want the editor to start in Tabs Out Mode (Y/N)? [N] :
  3621.         If you want Tabs Out mode to be ON each time QEdit is executed,
  3622.         then set this option to <Y>.  Refer to the "Modes" section of
  3623.         Chapter 1 for more information on Tabs Out.
  3624.  
  3625.     ■ Default physical tab width [2,4, or 8] [8]:
  3626.         This is the tab width that QEdit uses when Physical Tab
  3627.         Expansion mode or Tabs Out mode are ON.
  3628.  
  3629.     ■ Default Cursor tab width [2..12] [8]:
  3630.         This is the tab width that QEdit uses when you enter the TabRt
  3631.         and TabLt commands.
  3632.  
  3633.     ■ Default file extension number 1 for default tabs [.pas]:
  3634.       Physical tab width for above [2]:
  3635.       Cursor tab width for above [2]:
  3636.  
  3637.     ■ Default file extension number 2 for default tabs [.inc]:
  3638.       Physical tab width for above [2]:
  3639.       Cursor tab width for above [2]:
  3640.  
  3641.     ■ Default file extension number 3 for default tabs [.asm]:
  3642.       Physical tab width for above [8]:
  3643.       Cursor tab width for above [8]:
  3644.  
  3645.                                2-18
  3646.  
  3647.     ■ Default file extension number 4 for default tabs [.c]:
  3648.       Physical tab width for above [4]:
  3649.       Cursor tab width for above [4]:
  3650.  
  3651.     ■ Default file extension number 5 for default tabs [.h]:
  3652.       Physical tab width for above [4]:
  3653.       Cursor tab width for above [4]:
  3654.  
  3655.     ■ Default file extension number 6 for default tabs [.doc]:
  3656.       Physical tab width for above [8]:
  3657.       Cursor tab width for above [8]:
  3658.  
  3659.         QEdit allows you to set default physical and cursor tab widths
  3660.         for up to six different file extensions.  When a file is loaded
  3661.         that matches one of these extensions, these defaults are used.
  3662.         Otherwise, the defaults set in the first two Tab Settings are
  3663.         used.
  3664.  
  3665.     ■ Do you want the editor to start in Smart Tabs Mode (Y/N)? [N] :
  3666.         If you want Smart Tabs mode to be ON each time QEdit is
  3667.         executed, then set this option to <Y>.  Refer to the "Modes"
  3668.         section of Chapter 1 for more information on Smart Tabs.
  3669.  
  3670.                                2-19
  3671.  
  3672.  
  3673.     Chapter 3. QEdit Command Reference
  3674.     =========================================================================
  3675.  
  3676.     This chapter contains a description for each of the QEdit commands.
  3677.     Where appropriate, the default key assignments are provided.
  3678.     Additionally, <Esc> sequences are given for those commands which can
  3679.     be accessed through the "Pop-Down" menus.
  3680.  
  3681.     To assign commands which do not have a default assignment or to
  3682.     change existing key assignments, refer to the "Keyboard
  3683.     Configuration" section of Chapter 2 for instructions.
  3684.  
  3685.  
  3686.     AddLine             <F2> or <Esc><E><A>
  3687.     ─────────────────────────────────────────────────────────────────────────
  3688.  
  3689.     Adds a blank line after the cursor line, placing the cursor on the
  3690.     newly created line.  The cursor column does not change.
  3691.  
  3692.  
  3693.     Align
  3694.     ─────────────────────────────────────────────────────────────────────────
  3695.  
  3696.     Aligns the text on the cursor line with the text on the line
  3697.     immediately before the cursor line and then positions the cursor on
  3698.     the next line.  The cursor column does not change.  If the cursor is
  3699.     on line one, or the previous line is blank, or the cursor line is
  3700.     blank, this command will only move the cursor to the next line.
  3701.  
  3702.  
  3703.     AppendScrbuff       <Ctrl BA>
  3704.     ─────────────────────────────────────────────────────────────────────────
  3705.  
  3706.     Appends the currently marked Block to the end of the named Scratch
  3707.     Buffer.  The existing contents of the named Scratch Buffer are not
  3708.     lost. If the named Scratch Buffer does not exist, a new Scratch
  3709.     Buffer will be created.
  3710.  
  3711.  
  3712.     Backspace           <Backspace>
  3713.     ─────────────────────────────────────────────────────────────────────────
  3714.  
  3715.     If Insert mode is ON:
  3716.      Deletes the character to the left of the cursor.  The text to the
  3717.      right of, and including the cursor position, shifts left one
  3718.      position. If the cursor is in column one, the cursor line is
  3719.      appended to the end of the preceding line.
  3720.  
  3721.     If Insert mode is OFF:
  3722.      Deletes the character to the left of the cursor.  The text to the
  3723.      right of the cursor does NOT close in or shift.  If the cursor is
  3724.      in column one, however, the cursor line will still be appended to
  3725.      the end of the previous line.
  3726.  
  3727.                                3-2
  3728.  
  3729.  
  3730.     BegFile             <Ctrl PgUp>
  3731.     ─────────────────────────────────────────────────────────────────────────
  3732.  
  3733.     Positions the cursor at column one on the first line of the current
  3734.     file.
  3735.  
  3736.  
  3737.     BegLine             <Home>
  3738.     ─────────────────────────────────────────────────────────────────────────
  3739.  
  3740.     Positions the cursor at column one of the current cursor line.
  3741.  
  3742.  
  3743.     BegScreen           <Ctrl Home>
  3744.     ─────────────────────────────────────────────────────────────────────────
  3745.  
  3746.     Positions the cursor at the top line of the current window.  The
  3747.     cursor column does not change.
  3748.  
  3749.  
  3750.     ChangeFilename      <Alt O> or <Alt F><C> or <Esc><F><C>
  3751.     ─────────────────────────────────────────────────────────────────────────
  3752.  
  3753.     Changes the name of the current file.  QEdit will prompt for the new
  3754.     name.  If the file already exists, you will be required to confirm
  3755.     that you still want to rename the file.  The current file is marked
  3756.     as being a changed file.  (An asterisk will appear on the Status
  3757.     Line preceding the filename.)  This command will have no effect on
  3758.     disk files, until the renamed file is saved.
  3759.  
  3760.  
  3761.     CloseWindow         <Ctrl OC> or <Esc><W><C>
  3762.     ─────────────────────────────────────────────────────────────────────────
  3763.  
  3764.     Closes the current window, unless it is the only window which is
  3765.     open, in which case the command has no effect.
  3766.  
  3767.  
  3768.     Copy                <grey +>
  3769.     ─────────────────────────────────────────────────────────────────────────
  3770.  
  3771.     Copies the marked Block into the Scrap Buffer.  The Block is then
  3772.     unmarked.  If no Block is marked, the cursor line is copied into the
  3773.     Scrap Buffer.  The copying of the cursor line, when a Block is not
  3774.     marked, is configurable.  Refer to the "Advanced Options" section of
  3775.     Chapter 2 for more information.
  3776.  
  3777.  
  3778.     CopyBlock           <Alt C> or <Esc><B><C>
  3779.     ─────────────────────────────────────────────────────────────────────────
  3780.  
  3781.     Copies the marked Block to the cursor position.  If the Block is a
  3782.     character Block (created using the DropAnchor, MarkCharacter, or
  3783.     MarkBlockBegin/End commands)
  3784.  
  3785.                                3-3
  3786.  
  3787.  
  3788.     or a column Block (created using the MarkColumn command), the Block
  3789.     is inserted into the text beginning at the current cursor position.
  3790.     If the Block is a line Block (created using the MarkLine command),
  3791.     it is inserted before or after the current cursor line, depending on
  3792.     the configuration setting (Refer to the "General Options" section of
  3793.     Chapter 2 for more information).  The Block remains marked.  Blocks
  3794.     may be copied from one file to another.
  3795.  
  3796.  
  3797.     CopyOverBlock       <Alt Z>
  3798.     ─────────────────────────────────────────────────────────────────────────
  3799.     Copies the currently marked column Block and places it at the
  3800.     current cursor position by overlaying existing text and without
  3801.     shifting text to the right.  This command only works with column
  3802.     Blocks.  The Block remains marked.  Blocks may be "copied over" from
  3803.     one file to another.
  3804.  
  3805.  
  3806.     CurrentFilename
  3807.     ─────────────────────────────────────────────────────────────────────────
  3808.  
  3809.     Returns the name of the currently edited file, as if it had been
  3810.     typed at the keyboard.  This command is useful for manipulation of
  3811.     files from within macros.  It may only be used in response to QEdit
  3812.     prompting for a filename.
  3813.  
  3814.  
  3815.     CursorDown          <Cursor Down>
  3816.     ─────────────────────────────────────────────────────────────────────────
  3817.  
  3818.     Moves the cursor downward in the file to the next line.
  3819.  
  3820.  
  3821.     CursorLeft          <Cursor Left>
  3822.     ─────────────────────────────────────────────────────────────────────────
  3823.  
  3824.     Moves the cursor one character to the left.  When the cursor reaches
  3825.     the left edge of the screen, it stops, unless the text has been
  3826.     scrolled left, in which case the text scrolls right one position.
  3827.  
  3828.  
  3829.     CursorRight         <Cursor Right>
  3830.     ─────────────────────────────────────────────────────────────────────────
  3831.  
  3832.     Moves the cursor one character to the right.  When the cursor
  3833.     reaches the right end of the screen, the text starts scrolling left
  3834.     until the cursor reaches the maximum line length.
  3835.  
  3836.  
  3837.     CursorUp            <Cursor Up>
  3838.     ─────────────────────────────────────────────────────────────────────────
  3839.  
  3840.     Moves the cursor upward in the file to the previous line.
  3841.  
  3842.                                3-4
  3843.  
  3844.  
  3845.     Cut                 <grey ->
  3846.     ─────────────────────────────────────────────────────────────────────────
  3847.  
  3848.     Copies the marked Block into the Scrap Buffer.  The Block is then
  3849.     deleted from the file being edited.  If no Block is marked, the
  3850.     cursor line is cut into the Scrap Buffer.  The cutting of the cursor
  3851.     line, when a Block is not marked, is configurable.  Refer to the
  3852.     "Advanced Options" section of Chapter 2 for more information.
  3853.  
  3854.  
  3855.     DelCh               <Del>
  3856.     ─────────────────────────────────────────────────────────────────────────
  3857.  
  3858.     Deletes the character at the current cursor position.  The line to
  3859.     the right of the cursor shifts left one position.  If the cursor
  3860.     position is past the last character on the line, the next line is
  3861.     appended to the cursor line.  The "joining" of the next line when
  3862.     the cursor is past the last character on the line is configurable.
  3863.     Refer to the "General Options" section of Chapter 2 for more
  3864.     information.
  3865.  
  3866.  
  3867.     DeleteBlock         <Alt G> or <Esc><B><D>
  3868.     ─────────────────────────────────────────────────────────────────────────
  3869.  
  3870.     Deletes the currently marked character or line Block.  If there is
  3871.     not a Block marked in the current file, this command has no effect.
  3872.  
  3873.     Use the Cut command to delete a column Block.
  3874.  
  3875.  
  3876.     DelLine             <Alt D> or <Esc><E><D>
  3877.     ─────────────────────────────────────────────────────────────────────────
  3878.  
  3879.     Deletes the cursor line.  The line following the cursor line becomes
  3880.     the new cursor line.
  3881.  
  3882.  
  3883.     DelLtWord           <Ctrl Backspace>
  3884.     ─────────────────────────────────────────────────────────────────────────
  3885.  
  3886.     Deletes the "word" to the left of the cursor.  If the cursor is in
  3887.     column one, the cursor line is appended to the end of the preceding
  3888.     line.
  3889.  
  3890.  
  3891.     DelRtWord           <Ctrl T>
  3892.     ─────────────────────────────────────────────────────────────────────────
  3893.  
  3894.     Deletes the "word" to the right of the cursor.  If the cursor
  3895.     position is past the last character on the line, the next line is
  3896.     appended to the cursor line.
  3897.  
  3898.                                3-5
  3899.  
  3900.  
  3901.     DelToEol            <F6> or <Esc><E><E>
  3902.     ─────────────────────────────────────────────────────────────────────────
  3903.  
  3904.     Deletes text on the cursor line, from the cursor position to the end
  3905.     of line.
  3906.  
  3907.  
  3908.     Dos                 <Alt F9>
  3909.     ─────────────────────────────────────────────────────────────────────────
  3910.  
  3911.     QEdit prompts for a command, which is passed to DOS for execution.
  3912.     After the command is executed by DOS, control is returned to QEdit.
  3913.     If you want to execute a series of commands in DOS, you should use
  3914.     the Shell command, described later in this chapter.
  3915.  
  3916.     ┌─────────────────────────────────┐
  3917.     │ QEdit Tip:                      │
  3918.     │   You should NOT execute any    │
  3919.     │   TSR (terminate and stay       │
  3920.     │   resident) programs here.      │
  3921.     │   These include the DOS print   │
  3922.     │   and graph commands and        │
  3923.     │   memory-resident programs      │
  3924.     │   such as Sidekick and Superkey.│
  3925.     └─────────────────────────────────┘
  3926.  
  3927.  
  3928.     DropAnchor          <Alt A>
  3929.     ─────────────────────────────────────────────────────────────────────────
  3930.  
  3931.     This command is used to mark a character Block.  Initially executing
  3932.     this command will mark one end of a Block at the cursor position.
  3933.     As the cursor is moved, the Block will "grow" with it.  Executing
  3934.     this command again will mark the other end of the Block at the
  3935.     cursor position.  If DropAnchor is executed in a file that already
  3936.     contains a character Block, the Block is extended to the current
  3937.     cursor position.
  3938.  
  3939.  
  3940.     DupLine             <F4>
  3941.     ─────────────────────────────────────────────────────────────────────────
  3942.  
  3943.     Makes a copy of the current cursor line and inserts the copy
  3944.     immediately following the cursor line.  The cursor is moved to the
  3945.     new line.
  3946.  
  3947.  
  3948.     EditFile            <Alt E> or <Alt F><L> or <Esc><F><L>
  3949.     ─────────────────────────────────────────────────────────────────────────
  3950.  
  3951.     The editor prompts for the name(s) of the additional file(s) to be
  3952.     edited.  Wildcard characters (* or ?) are permissible, as are
  3953.     multiple filenames.  The editor will not load multiple copies of the
  3954.     same file.  If you issue the EditFile command using the name of a
  3955.     file that has already been loaded, QEdit will simply make that file
  3956.     the current file.
  3957.  
  3958.                                3-6
  3959.  
  3960.  
  3961.     EndFile             <Ctrl PgDn>
  3962.     ─────────────────────────────────────────────────────────────────────────
  3963.  
  3964.     Positions the cursor on the last line of the file immediately
  3965.     following the last non-blank character.  If the last line of the
  3966.     file is blank, the cursor is positioned in column one.
  3967.  
  3968.  
  3969.     EndLine             <End>
  3970.     ─────────────────────────────────────────────────────────────────────────
  3971.  
  3972.     Positions the cursor immediately following the last non-blank
  3973.     character on the cursor line.
  3974.  
  3975.  
  3976.     EndScreen           <Ctrl End>
  3977.     ─────────────────────────────────────────────────────────────────────────
  3978.  
  3979.     The cursor is positioned on the last line of the current window.
  3980.     The cursor column does not change.
  3981.  
  3982.  
  3983.     Escape              <Esc>
  3984.     ─────────────────────────────────────────────────────────────────────────
  3985.  
  3986.     If executed while editing, the "Pop-Down" menus are displayed.
  3987.     Otherwise, this command aborts any editor prompt.
  3988.  
  3989.  
  3990.     ExecuteScrap        <Ctrl Enter>
  3991.     ─────────────────────────────────────────────────────────────────────────
  3992.  
  3993.     Plays back the latest macro that was created using the MacroRecord
  3994.     command.
  3995.  
  3996.  
  3997.     Exit                <Ctrl KD>
  3998.     ─────────────────────────────────────────────────────────────────────────
  3999.  
  4000.     Conditionally discards the current file.  If the file has not been
  4001.     modified, the file is discarded without prompting.  If the file has
  4002.     been modified, the editor prompts with "Save Changes (Y/N)?".
  4003.     Pressing <Y> will save and then discard the file.  Pressing <N> will
  4004.     discard the file without saving any changes.
  4005.  
  4006.     QEdit can be configured, when only a single file is being edited and
  4007.     the Exit command is issued, to either terminate or prompt for
  4008.     another file to edit.  Refer to the "General Options" section of
  4009.     Chapter 2 for more information.
  4010.  
  4011.  
  4012.                                3-7
  4013.  
  4014.     File                <Ctrl KX> or <Alt F><F> or <Esc><F><F>
  4015.     ─────────────────────────────────────────────────────────────────────────
  4016.  
  4017.     Saves and then discards the current file.
  4018.  
  4019.     QEdit can be configured, when only a single file is being edited and
  4020.     the File command is issued, to either terminate or prompt for
  4021.     another file to edit.  Refer to the "General Options" section of
  4022.     Chapter 2 for more information.
  4023.  
  4024.  
  4025.     Find                <Ctrl QF> or <Esc><S><F>
  4026.     ─────────────────────────────────────────────────────────────────────────
  4027.  
  4028.     Searches for a specified string of characters within the current
  4029.     file. The User is prompted for a search string and search options.
  4030.     Available search options are:
  4031.  
  4032.           [I] Ignore the case of the search string.
  4033.           [W] Search for whole words only.
  4034.           [B] Search backwards from the current cursor position.
  4035.  
  4036.  
  4037.     FindReplace         <Ctrl QA> or <Esc><S><R>
  4038.     ─────────────────────────────────────────────────────────────────────────
  4039.  
  4040.     Searches and replaces strings within the current file.  The User is
  4041.     prompted for a search string, a replace string, and options.
  4042.     Available options are:
  4043.  
  4044.           [I] Ignore the case of the search string.
  4045.           [W] Search for whole words only.
  4046.           [B] Search backwards from the current cursor position.
  4047.           [N] Find and replace without prompting.
  4048.  
  4049.     At every occurrence of the search string in the file, the User is
  4050.     given the following replace options.
  4051.  
  4052.           [Y] Replace the search string with the replace string and
  4053.               continue on to the next occurrence of the search string.
  4054.           [N] Do not make any changes but continue on to the next
  4055.               occurrence of the search string.
  4056.           [O] Replace the search string with the replace string and
  4057.               then terminate the FindReplace process.
  4058.           [G] Replace the search string with the replace string for
  4059.               this and all occurrences throughout the file without
  4060.               any further prompting.
  4061.           [Q] Terminate the FindReplace process.
  4062.  
  4063.  
  4064.                                3-8
  4065.  
  4066.     GetPrev             <Ctrl - (dash)>
  4067.     ─────────────────────────────────────────────────────────────────────────
  4068.  
  4069.     Duplicates the character immediately above the cursor at the cursor
  4070.     position.
  4071.  
  4072.  
  4073.     GetScrbuff          <Ctrl BL>
  4074.     ─────────────────────────────────────────────────────────────────────────
  4075.  
  4076.     Inserts the contents of the named Scratch Buffer at the cursor
  4077.     position. Refer to the "Block Commands" section of Chapter 1 for
  4078.     more information.
  4079.  
  4080.  
  4081.     GExit               <Alt X> or <Alt Q><X> or <Esc><Q><X>
  4082.     ─────────────────────────────────────────────────────────────────────────
  4083.  
  4084.     Issues the Exit command for all files that have been loaded.  If no
  4085.     files have been modified, this command immediately terminates the
  4086.     editor and returns control to DOS.  If any files have been modified
  4087.     you are prompted with "Save Changes (Y/N)?" for each modified file.
  4088.  
  4089.     For example, if you have ten files loaded and two of them have been
  4090.     modified, then you will be prompted to save changes twice, once for
  4091.     each modified file.
  4092.  
  4093.  
  4094.     GFile               <Alt F><G> or <Esc><F><G>
  4095.     ─────────────────────────────────────────────────────────────────────────
  4096.  
  4097.     Instructs the editor to discard all files which have been loaded.
  4098.     Any files which have been modified will be saved.
  4099.  
  4100.     If no files have been changed, this command immediately terminates
  4101.     the editor and returns control to DOS.
  4102.  
  4103.  
  4104.     GotoBlockBeg        <Ctrl QB>
  4105.     ─────────────────────────────────────────────────────────────────────────
  4106.  
  4107.     Positions the cursor at the beginning of the currently marked Block.
  4108.     If the Block is in a file other than the current file, the file
  4109.     containing the Block becomes the new current file.
  4110.  
  4111.  
  4112.     GotoBlockEnd        <Ctrl QK>
  4113.     ─────────────────────────────────────────────────────────────────────────
  4114.  
  4115.     Positions the cursor at the end of the currently marked Block. If
  4116.     the Block is in a file other than the current file, the file
  4117.     containing the Block becomes the new current file.
  4118.  
  4119.                                3-9
  4120.  
  4121.  
  4122.     GotoLine            <Ctrl J>
  4123.     ─────────────────────────────────────────────────────────────────────────
  4124.  
  4125.     Positions the cursor at the requested line.  The editor will prompt
  4126.     for the desired line number.
  4127.  
  4128.  
  4129.     GPQuit              <F3> or <Alt Q><Q> or <Esc><Q><Q>
  4130.     ─────────────────────────────────────────────────────────────────────────
  4131.  
  4132.     Issues the PQuit command for all files that have been loaded.
  4133.  
  4134.  
  4135.     GrowWindow          <Ctrl OG> or <Esc><W><G>
  4136.     ─────────────────────────────────────────────────────────────────────────
  4137.  
  4138.     Increases the size of the current window if there are multiple
  4139.     windows on the screen.  The editor will prompt for the direction in
  4140.     which to increase the size.  The ShrinkWindow command can be
  4141.     executed from this prompt to decrease the window size.
  4142.  
  4143.  
  4144.     GSave               <Alt Y>
  4145.     ─────────────────────────────────────────────────────────────────────────
  4146.  
  4147.     Issues the SaveFile command for all files that have been modified.
  4148.  
  4149.  
  4150.     HalfPgDn
  4151.     ─────────────────────────────────────────────────────────────────────────
  4152.  
  4153.     Scrolls the text toward the end of the file one-half page.
  4154.  
  4155.  
  4156.     HalfPgUp
  4157.     ─────────────────────────────────────────────────────────────────────────
  4158.  
  4159.     Scrolls the text toward the beginning of the file one-half page.
  4160.  
  4161.  
  4162.     HorizontalWindow    <Ctrl OH> or <Esc><W><S>
  4163.     ─────────────────────────────────────────────────────────────────────────
  4164.  
  4165.     Splits the screen or current window horizontally, creating a new
  4166.     window.  Up to eight windows may be displayed on the screen at one
  4167.     time.
  4168.  
  4169.  
  4170.     InsertDate
  4171.     ─────────────────────────────────────────────────────────────────────────
  4172.  
  4173.     Inserts the system date at the current cursor position.
  4174.  
  4175.                                3-10
  4176.  
  4177.  
  4178.     InsertLine          <Alt F2> or <Esc><E><I>
  4179.     ─────────────────────────────────────────────────────────────────────────
  4180.  
  4181.     Inserts a blank line above the cursor line and positions the cursor
  4182.     on the newly created line.  The cursor column does not change.
  4183.  
  4184.  
  4185.     InsertTime
  4186.     ─────────────────────────────────────────────────────────────────────────
  4187.  
  4188.     Inserts the system time at the current cursor position.
  4189.  
  4190.  
  4191.     JoinLine            <Alt J> or <Esc><E><J>
  4192.     ─────────────────────────────────────────────────────────────────────────
  4193.  
  4194.     Joins the line below the cursor line to the end of the cursor line.
  4195.     If the cursor is past the end of the line, then the line is joined
  4196.     at the cursor position.
  4197.  
  4198.  
  4199.     KillFile            <Ctrl KZ>
  4200.     ─────────────────────────────────────────────────────────────────────────
  4201.  
  4202.     Erases the currently edited file from disk.  The file remains loaded
  4203.     in the editor and is marked as being a changed file.  (An asterisk
  4204.     will appear on the Status Line preceding the filename.)  This
  4205.     command is very useful when available disk space is low.
  4206.  
  4207.  
  4208.     LineDown
  4209.     ─────────────────────────────────────────────────────────────────────────
  4210.  
  4211.     Scrolls the text one line at a time toward the end of the file.  The
  4212.     cursor remains stationary on the screen.
  4213.  
  4214.  
  4215.     LineUp
  4216.     ─────────────────────────────────────────────────────────────────────────
  4217.  
  4218.     Scrolls the text one line at a time toward the beginning of the
  4219.     file.  The cursor remains stationary on the screen.
  4220.  
  4221.                                3-11
  4222.  
  4223.  
  4224.     Literal             <Ctrl P>
  4225.     ─────────────────────────────────────────────────────────────────────────
  4226.  
  4227.     Causes the editor to literally interpret the keystroke that is
  4228.     entered immediately following this command.  It is used to insert
  4229.     control characters into the currently edited file.  For example, to
  4230.     insert the ASCII form-feed character (ASCII 12), you would first
  4231.     press <Ctrl P> then <Ctrl L>.  To insert a "null" character into the
  4232.     file, press <Ctrl P> and then <Ctrl 2>.  (Note: The "2" must be the
  4233.     "2" key on the alphanumeric keyboard, NOT the key on the numeric
  4234.     keypad.)  Refer to the "Adding Text" section of Chapter 1 for more
  4235.     information.
  4236.  
  4237.  
  4238.     MacroRead           <Esc> <M><R>
  4239.     ─────────────────────────────────────────────────────────────────────────
  4240.  
  4241.     Loads the named macro file, with all macros contained therein, from
  4242.     disk into the editor's internal macro buffer.  The macros are
  4243.     assigned to the keys exactly as they were originally recorded and
  4244.     saved.  The editor prompts the User for the name of the file.
  4245.  
  4246.  
  4247.     MacroRecord         <Ctrl M> or <Esc><M><M>
  4248.     ─────────────────────────────────────────────────────────────────────────
  4249.  
  4250.     Toggles (ON and OFF) macro recording.  If macro recording is OFF,
  4251.     this will turn macro recording ON and prompt for a key to which to
  4252.     assign the macro.  After pressing the desired key (see Appendix B
  4253.     for a list of available keys), all following keystrokes are recorded
  4254.     until the MacroRecord key is pressed again.  After the macro has
  4255.     been recorded, it can be played back by pressing the key to which
  4256.     the macro was assigned.
  4257.  
  4258.     Instead of assigning a macro to a specific key, it can be assigned
  4259.     to a "scrap" or temporary area by simple pressing <Enter> at the
  4260.     prompt.  A macro assigned to the scrap area may be played back by
  4261.     entering the ExecuteScrap <Ctrl Enter> command.  The scrap area will
  4262.     be updated each time the MacroRecord command is executed.
  4263.  
  4264.  
  4265.  
  4266.     MacroWrite          <Esc> <M><W>
  4267.     ─────────────────────────────────────────────────────────────────────────
  4268.  
  4269.     Saves all currently defined macros to a binary disk file.  The
  4270.     editor prompts for the name of the file.
  4271.  
  4272.                                3-12
  4273.  
  4274.  
  4275.     MainMenu            <Esc>
  4276.     ─────────────────────────────────────────────────────────────────────────
  4277.  
  4278.     Activates the "Pop-Down" style menu system.  Many of the editor's
  4279.     commands can be executed via the menus.
  4280.  
  4281.  
  4282.     MakeBotofScreen
  4283.     ─────────────────────────────────────────────────────────────────────────
  4284.  
  4285.     Scrolls the text in the window so that the cursor line becomes the
  4286.     bottom line of the window.
  4287.  
  4288.  
  4289.     MakeCtrofScreen     <Shift F5>
  4290.     ─────────────────────────────────────────────────────────────────────────
  4291.  
  4292.     Scrolls the text in the window so that the cursor line becomes the
  4293.     center line of the window.
  4294.  
  4295.  
  4296.     MakeTopofScreen     <F5>
  4297.     ─────────────────────────────────────────────────────────────────────────
  4298.  
  4299.     Scrolls the text in the window so that the cursor line becomes the
  4300.     top line of the window.
  4301.  
  4302.  
  4303.     MarkBlockBegin      <Ctrl KB> or <Esc><B><B>
  4304.     ─────────────────────────────────────────────────────────────────────────
  4305.  
  4306.     Marks the beginning of a character Block.  The Block is not shown
  4307.     until the MarkBlockEnd command is executed at some position beyond
  4308.     the beginning position of the Block.  For an alternate method of
  4309.     marking character Blocks, refer to the DropAnchor and MarkCharacter
  4310.     commands.
  4311.  
  4312.  
  4313.     MarkBlockEnd        <Ctrl KK> or <Esc><B><E>
  4314.     ─────────────────────────────────────────────────────────────────────────
  4315.  
  4316.     Marks the end of a character Block.  The Block is not shown until
  4317.     the MarkBlockBegin command is also executed at some position before
  4318.     the end of the Block.  For an alternate method of marking character
  4319.     Blocks, refer to the DropAnchor and MarkCharacter commands.
  4320.  
  4321.                                3-13
  4322.  
  4323.  
  4324.     MarkCharacter
  4325.     ─────────────────────────────────────────────────────────────────────────
  4326.     This command is used to mark a character Block.  It is similar to
  4327.     the DropAnchor command except the cursor position is NOT included as
  4328.     part of the Block.
  4329.  
  4330.     This command is provided as a replacement for the DropAnchor
  4331.     command. If you want the cursor position included in character
  4332.     Blocks, then continue to use DropAnchor; otherwise, replace the
  4333.     DropAnchor command with this command.
  4334.  
  4335.  
  4336.     MarkColumn          <Alt K>
  4337.     ─────────────────────────────────────────────────────────────────────────
  4338.     This command is used to mark a column Block.  Initially executing
  4339.     this command will mark the current cursor position.  As the cursor
  4340.     is moved, the Block will "grow".  Executing this command again will
  4341.     mark the other end of the Block at the current cursor position.  If
  4342.     MarkColumn is executed in a file that already contains a Block, the
  4343.     Block is extended to the current cursor position.
  4344.  
  4345.  
  4346.     MarkLine            <Alt L> or <Esc><B><L>
  4347.     ─────────────────────────────────────────────────────────────────────────
  4348.  
  4349.     This command is used to mark a line Block.  Initially executing this
  4350.     command will mark the current cursor line.  As the cursor is moved,
  4351.     the Block will "grow" with it line by line.  Executing this command
  4352.     again will mark the other end of the Block at the current cursor
  4353.     line.  If MarkLine is executed in a file that already contains a
  4354.     Block, the Block is extended to the current cursor line.
  4355.  
  4356.  
  4357.     Match               <Alt F3>
  4358.     ─────────────────────────────────────────────────────────────────────────
  4359.  
  4360.     Will find the corresponding "(", ")", "{", "}", "[", "]" character.
  4361.     This command is primarily intended for programming languages in
  4362.     which complicated expressions are grouped with one or more of these
  4363.     characters.  This command is very useful for finding unmatched
  4364.     parentheses.
  4365.  
  4366.  
  4367.     MoveBlock           <Alt M> or <Esc><B><M>
  4368.     ─────────────────────────────────────────────────────────────────────────
  4369.  
  4370.     Moves (copies and deletes) the currently marked Block to the cursor
  4371.     position.  If the Block is a character Block (created using the
  4372.     DropAnchor, MarkCharacter, or MarkBlockBegin/End commands) or a
  4373.     column Block (created using the MarkColumn command), the Block is
  4374.     inserted into the text beginning at the current cursor position.  If
  4375.     the Block is a line Block (created using the MarkLine command), it
  4376.  
  4377.                                3-14
  4378.  
  4379.     is inserted before or after the current cursor line, depending on
  4380.     the configuration setting  (Refer to the "General Options" section
  4381.     of Chapter 2 for more information).  The Block remains marked.
  4382.     Blocks may be moved from one file to another.
  4383.  
  4384.     NextFile            <Alt N> or <Alt F><N> or <Esc><F><N>
  4385.     ─────────────────────────────────────────────────────────────────────────
  4386.  
  4387.     Makes the next file in the ring the new current file when multiple
  4388.     files are loaded.
  4389.  
  4390.  
  4391.     NextWindow          <Ctrl ON> or <Esc><W><N>
  4392.     ─────────────────────────────────────────────────────────────────────────
  4393.  
  4394.     Makes the window below the current window the new current window.
  4395.     If the current window is at the bottom of the screen, the top window
  4396.     on the screen will become the current window.
  4397.  
  4398.  
  4399.     OneWindow           <Ctrl OO> or <Esc><W><O>
  4400.     ─────────────────────────────────────────────────────────────────────────
  4401.  
  4402.     Closes all windows except the current window and expands it to
  4403.     occupy the entire screen.
  4404.  
  4405.  
  4406.     PageDown            <PgDn>
  4407.     ─────────────────────────────────────────────────────────────────────────
  4408.  
  4409.     Scrolls the text toward the end of the file, one page-full less one
  4410.     line, at a time.
  4411.  
  4412.  
  4413.     PageUp              <PgUp>
  4414.     ─────────────────────────────────────────────────────────────────────────
  4415.  
  4416.     Scrolls the text toward the top of the file, one page-full less one
  4417.     line, at a time.
  4418.  
  4419.  
  4420.  
  4421.     Paste               <grey *>
  4422.     ─────────────────────────────────────────────────────────────────────────
  4423.  
  4424.     Inserts the contents of the Scrap Buffer at the cursor position.
  4425.     The Scrap Buffer is loaded using the Cut or Copy commands.  If the
  4426.     Scrap Buffer contains a character or column Block, it is inserted at
  4427.     the cursor position. If the Scrap Buffer contains a line Block, it
  4428.     is inserted before or after the cursor line depending on the
  4429.     configuration setting.  Refer to the "General Options" section of
  4430.     Chapter 2 for more information.
  4431.  
  4432.                                3-15
  4433.  
  4434.  
  4435.     PasteOver           <Ctrl PrtSc>
  4436.     ─────────────────────────────────────────────────────────────────────────
  4437.     This is a Paste command for column Blocks.  It takes a column Block
  4438.     which has been loaded into the Scrap Buffer using the Cut or Copy
  4439.     commands and places it at the current cursor position by overlaying
  4440.     existing text and without shifting text to the right.
  4441.  
  4442.  
  4443.     PQuit               <Ctrl KQ> or <Alt F><Q> or <Esc><F><Q>
  4444.     ─────────────────────────────────────────────────────────────────────────
  4445.  
  4446.     This command initiates a protected quit.  If the current file has
  4447.     not been modified, it is discarded.  If the current file has been
  4448.     modified, the User is warned that changes will be lost.  If multiple
  4449.     files are being edited, this command will make the previous file in
  4450.     the ring the new current file.
  4451.  
  4452.     QEdit can be configured, when only a single file is being edited and
  4453.     the PQuit command is issued, to either terminate or prompt for
  4454.     another file to edit.  Refer to the "General Options" section of
  4455.     Chapter 2 for more information.
  4456.  
  4457.  
  4458.     PrevFile            <Ctrl KP> or <Alt F><P> or <Esc><F><P>
  4459.     ─────────────────────────────────────────────────────────────────────────
  4460.  
  4461.     Makes the previous file in the ring the new current file when
  4462.     multiple files are loaded.
  4463.  
  4464.  
  4465.     PrevPosition        <Ctrl QP>
  4466.     ─────────────────────────────────────────────────────────────────────────
  4467.  
  4468.     Positions the cursor at the previous cursor position.  Very helpful
  4469.     when used with the GotoLine command.  The GotoLine line can be used
  4470.     to go directly to a certain area of the file.  The PrevPosition can
  4471.     then be used to return you to the original cursor position.
  4472.  
  4473.  
  4474.     PrevWindow          <Ctrl OP> or <Esc><W><P>
  4475.     ─────────────────────────────────────────────────────────────────────────
  4476.  
  4477.     Makes the window above the current window the new current window. If
  4478.     the current window is at the top of the screen, the bottom window on
  4479.     the screen will become the current window.
  4480.  
  4481.  
  4482.     PrintAll            <Alt P><A> or <Esc><P><A>
  4483.     ─────────────────────────────────────────────────────────────────────────
  4484.  
  4485.     Prints the entire contents of the current file.
  4486.  
  4487.                                3-16
  4488.  
  4489.  
  4490.     PrintBlock          <Alt P><B> or <Esc><P><B>
  4491.     ─────────────────────────────────────────────────────────────────────────
  4492.  
  4493.     Prints the entire contents of the marked Block.  The marked Block
  4494.     must be in the current file.
  4495.  
  4496.  
  4497.     PrintEject          <Alt P><F> or <Esc><P><F>
  4498.     ─────────────────────────────────────────────────────────────────────────
  4499.  
  4500.     Sends a formfeed character (ASCII 12) to the printer.
  4501.  
  4502.  
  4503.     QuickHelp           <F1> or <Alt H>
  4504.     ─────────────────────────────────────────────────────────────────────────
  4505.  
  4506.     Displays the Help Screen.  A Help Screen is provided with QEdit;
  4507.     however, you may wish to design your own Help Screen.  For more
  4508.     information, refer to the "The Help Screen" section of Chapter 2.
  4509.  
  4510.  
  4511.     Quit
  4512.     ─────────────────────────────────────────────────────────────────────────
  4513.  
  4514.     Unconditional quit.  The current file is discarded regardless of any
  4515.     changes made to it.  This command is for those who do not like
  4516.     software that "nags" you.  USE WITH CAUTION!
  4517.  
  4518.  
  4519.     ReadBlock           <Alt R> or <Alt F><R> or <Esc><F><R>
  4520.     ─────────────────────────────────────────────────────────────────────────
  4521.  
  4522.     Inserts the named disk file at the current cursor position.
  4523.  
  4524.  
  4525.     RepeatFind          <Ctrl L> or <Esc><S><A>
  4526.     ─────────────────────────────────────────────────────────────────────────
  4527.  
  4528.     Repeats the previous Find or FindReplace command.
  4529.  
  4530.  
  4531.     Return              <Enter>
  4532.     ─────────────────────────────────────────────────────────────────────────
  4533.  
  4534.     The Return command behaves differently depending on Insert mode and
  4535.     AutoIndent mode.
  4536.  
  4537.     If Insert mode is OFF, the cursor is positioned at the first column
  4538.     of the next line.
  4539.  
  4540.                                3-17
  4541.  
  4542.     If Insert mode is ON, the current cursor line is split at the cursor
  4543.     position and any text to the right of and including the cursor
  4544.     position is placed on a new line following the current line.  If the
  4545.     cursor is past the last character on the line, then a blank line is
  4546.     added following the current line.  The cursor is then moved to the
  4547.     first column of the new line.
  4548.  
  4549.     If AutoIndent is ON, spaces are inserted ahead of the cursor
  4550.     position to align it with the text on the previous line.
  4551.  
  4552.     If AutoIndent is OFF, the text is moved to the beginning of the
  4553.     next line.
  4554.  
  4555.     The Return command can be configured to split or not to split lines
  4556.     when Insert mode is ON.  Refer to the "Advanced Options" section of
  4557.     Chapter 2 for more information.
  4558.  
  4559.  
  4560.     SaveFile            <Ctrl KS> or <Alt F><S> or <Esc><F><S>
  4561.     ─────────────────────────────────────────────────────────────────────────
  4562.  
  4563.     Saves to disk the file currently being edited.  The file remains
  4564.     loaded, ready for further editing.
  4565.  
  4566.  
  4567.     ScreenLeft          <Alt F5>
  4568.     ─────────────────────────────────────────────────────────────────────────
  4569.  
  4570.     Shifts the screen to the left, the number of columns specified in
  4571.     the configuration program.  Refer to the "Colors/Screen Options"
  4572.     section of Chapter 2 for more information.
  4573.  
  4574.  
  4575.     ScreenRight         <Alt F6>
  4576.     ─────────────────────────────────────────────────────────────────────────
  4577.  
  4578.     Shifts the screen to the Right, the number of columns specified in
  4579.     the configuration program.  Refer to the "Colors/Screen Options"
  4580.     section of Chapter 2 for more information.
  4581.  
  4582.  
  4583.     ScrollDown          <Ctrl Z>
  4584.     ─────────────────────────────────────────────────────────────────────────
  4585.  
  4586.     Scrolls the text one line at a time toward the end of the file.  The
  4587.     cursor remains on the same line of text until it reaches the top of
  4588.     the screen.
  4589.  
  4590.                                3-18
  4591.  
  4592.  
  4593.     ScrollUp            <Ctrl W>
  4594.     ─────────────────────────────────────────────────────────────────────────
  4595.  
  4596.     Scrolls the text one line at a time toward the beginning of the
  4597.     file.  The cursor remains on the same line of text until it reaches
  4598.     the bottom of the screen.
  4599.  
  4600.  
  4601.     SetCtabwidth        <Esc><O><C>
  4602.     ─────────────────────────────────────────────────────────────────────────
  4603.  
  4604.     Sets the cursor tab width.  This is the width that is used when the
  4605.     TabRt or TabLt commands are executed.
  4606.  
  4607.  
  4608.     SetEGA25
  4609.     ─────────────────────────────────────────────────────────────────────────
  4610.     Switches a monitor with an EGA or VGA card to 25-line mode.  This
  4611.     command has no effect if the video card is not an EGA or VGA type.
  4612.  
  4613.  
  4614.     SetEGA43
  4615.     ─────────────────────────────────────────────────────────────────────────
  4616.     Switches a monitor with an EGA or VGA card to 43-line mode or
  4617.     50-line mode, respectively.  This command has no effect if the video
  4618.     card is not an EGA or VGA type.
  4619.  
  4620.  
  4621.     SetPrintLeftMargin  <Alt P><L> or <Esc><P><L>
  4622.     ─────────────────────────────────────────────────────────────────────────
  4623.  
  4624.     Sets the number of spaces to be printed as a left margin at the
  4625.     beginning of each line. The default is zero.
  4626.  
  4627.  
  4628.     SetPrintPageSize    <Alt P><P> or <Esc><P><P>
  4629.     ─────────────────────────────────────────────────────────────────────────
  4630.  
  4631.     Sets the number of lines to be printed per page before sending a
  4632.     formfeed.  A value of zero will allow continuous printing (no
  4633.     formfeeds sent).
  4634.  
  4635.  
  4636.     SetPtabwidth        <Esc><O><P>
  4637.     ─────────────────────────────────────────────────────────────────────────
  4638.  
  4639.     Sets the Physical Tab Width.  This determines the width to which
  4640.     physical tab characters found in files are expanded if Physical Tab
  4641.     Expansion is set ON.  It also determines the number of spaces to be
  4642.     used for Tabs Out mode.  Refer to the ToggleTabsExpand and
  4643.     ToggleTabsOut commands in this chapter for more information.
  4644.  
  4645.                                3-19
  4646.  
  4647.  
  4648.     SetRmargin          <Ctrl OR> or <Esc><O><R>
  4649.     ─────────────────────────────────────────────────────────────────────────
  4650.  
  4651.     Sets the right margin for word-wrap and paragraph reformatting.
  4652.     WordWrap mode is automatically switched ON whenever the right margin
  4653.     is set using this command.
  4654.  
  4655.  
  4656.     Shell               <F9> or <Alt F><O> or <Esc><F><O>
  4657.     ─────────────────────────────────────────────────────────────────────────
  4658.  
  4659.     Invokes a DOS shell.  While in the shell, you can execute DOS and
  4660.     other commands.  When you are ready to leave the shell, type
  4661.     "exit <Enter>".  You will be back in QEdit, exactly where you
  4662.     left off.
  4663.  
  4664.     ┌─────────────────────────────────┐
  4665.     │ QEdit Tip:                      │
  4666.     │   You should NOT execute any    │
  4667.     │   TSR (terminate and stay       │
  4668.     │   resident) programs here.      │
  4669.     │   These include the DOS print   │
  4670.     │   and graph commands and        │
  4671.     │   memory-resident programs      │
  4672.     │   such as Sidekick and Superkey.│
  4673.     └─────────────────────────────────┘
  4674.  
  4675.  
  4676.  
  4677.     ShiftLeft           <Shift F7>
  4678.     ─────────────────────────────────────────────────────────────────────────
  4679.  
  4680.     Shifts the contents of the currently marked Block (or the cursor
  4681.     line, if the cursor does not reside in a marked Block) one position
  4682.     to the left.  If you issue this command when the leftmost
  4683.     character(s) of the line(s) being shifted is in column 1, that
  4684.     character(s) will be deleted to allow the remainder of the line to
  4685.     shift left one position.
  4686.  
  4687.  
  4688.     ShiftRight          <Shift F8>
  4689.     ─────────────────────────────────────────────────────────────────────────
  4690.  
  4691.     Shifts the contents of the currently marked Block (or the cursor
  4692.     line, if the cursor does not reside in a marked Block) one position
  4693.     to the right.  If you issue this command when the rightmost
  4694.     character(s) of the line(s) being shifted is in column 512, that
  4695.     character(s) will be deleted to allow the remainder of the line to
  4696.     shift right one position.
  4697.  
  4698.  
  4699.     ShowEntryScreen     <Alt F10>
  4700.     ─────────────────────────────────────────────────────────────────────────
  4701.  
  4702.     Displays the original DOS screen as it appeared upon initial
  4703.     execution of the editor.  Pressing any key will return you to the
  4704.     edit screen.
  4705.  
  4706.                                3-20
  4707.  
  4708.  
  4709.     ShrinkWindow        <Ctrl OS> or <Esc><W><R>
  4710.     ─────────────────────────────────────────────────────────────────────────
  4711.  
  4712.     Decreases the size of the current window, if there are multiple
  4713.     windows on the screen.  The editor will prompt for the direction in
  4714.     which to decrease the size.  The GrowWindow command can be executed
  4715.     from this prompt to increase the window size.
  4716.  
  4717.  
  4718.  
  4719.     SplitLine           <Alt S> or <Esc><E><S>
  4720.     ─────────────────────────────────────────────────────────────────────────
  4721.  
  4722.     Splits the current cursor line at the cursor position.  Any text to
  4723.     the right of and including the cursor position is placed on a new
  4724.     line following the current line.  If the cursor is past the last
  4725.     character on the line, then a blank line is added following the
  4726.     current line. The cursor position does not change.
  4727.  
  4728.  
  4729.     StoreScrbuff        <Ctrl BS>
  4730.     ─────────────────────────────────────────────────────────────────────────
  4731.  
  4732.     Copies the currently marked Block to the named Scratch Buffer. The
  4733.     editor will prompt for the name of the Scratch Buffer.  The contents
  4734.     of all Scratch Buffers are lost when the editor is terminated.
  4735.  
  4736.  
  4737.     TabLt               <Shift Tab>
  4738.     ─────────────────────────────────────────────────────────────────────────
  4739.  
  4740.     Positions the cursor at the previous tab position, as defined by the
  4741.     tab width.  If in Insert mode, the text to the right of, and
  4742.     including the cursor position, also shifts left.
  4743.  
  4744.  
  4745.     TabRt               <Tab>
  4746.     ─────────────────────────────────────────────────────────────────────────
  4747.  
  4748.     Positions the cursor at the next tab position, as defined by the
  4749.     cursor tab width.  If in Insert mode, the text to the right of, and
  4750.     including the cursor position, also shifts right.
  4751.  
  4752.  
  4753.     ToggleBakups        <Esc><O><B>
  4754.     ─────────────────────────────────────────────────────────────────────────
  4755.  
  4756.     Toggles file backups ON and OFF.  If ON, QEdit will create a backup
  4757.     file using the ".bak" file extension whenever a modified file is
  4758.     saved.
  4759.  
  4760.                                3-21
  4761.  
  4762.  
  4763.     ToggleBoxDraw       <Shift F1>
  4764.     ─────────────────────────────────────────────────────────────────────────
  4765.  
  4766.     Toggles Box Drawing mode ON and OFF.  If ON, the cursor movement
  4767.     keys (up, down, right, left) will "draw" lines in the text, both
  4768.     up/down and right/left.  Very useful for creating charts and tables.
  4769.  
  4770.     The letter "B" will appear on the Status Line when this mode is ON.
  4771.  
  4772.  
  4773.     ToggleEGA43         <Ctrl F1>
  4774.     ─────────────────────────────────────────────────────────────────────────
  4775.     Toggles an EGA monitor between 25-line and 43-line mode or a VGA
  4776.     monitor between 25-line and 50-line mode.  This command has no
  4777.     effect if the video card is not an EGA or VGA type.
  4778.  
  4779.  
  4780.     ToggleEnterMatching <Esc><O><E>
  4781.     ─────────────────────────────────────────────────────────────────────────
  4782.  
  4783.     Toggles EnterMatching mode ON and OFF.  If ON, the double quote,
  4784.     parenthesis, and square bracket keys all automatically enter the
  4785.     matching character when the left character is entered.  For example,
  4786.     typing the '[' key automatically enters a ']' immediately following.
  4787.  
  4788.  
  4789.     ToggleIndent        <Ctrl QI> or <Esc><O><A>
  4790.     ─────────────────────────────────────────────────────────────────────────
  4791.  
  4792.     Toggles AutoIndent mode ON and OFF.  If ON, the cursor is positioned
  4793.     at the current left margin whenever the <Enter> key is pressed.
  4794.     The current left margin is determined by the first non-blank
  4795.     character on the immediately preceding line.
  4796.  
  4797.     Paragraph reformatting and word-wrapping will also use the current
  4798.     left margin when AutoIndent mode is ON.
  4799.  
  4800.     The letter "A" will appear on the Status Line when this mode is ON.
  4801.  
  4802.  
  4803.     ToggleInsert        <Ins> or <Esc><O><I>
  4804.     ─────────────────────────────────────────────────────────────────────────
  4805.  
  4806.     Toggles Insert mode ON and OFF.  If ON, text to the right of the
  4807.     cursor on the cursor line is shifted whenever characters, spaces,
  4808.     the Backspace command, the TabLt command, or the TabRt command is
  4809.     entered.  Also, entering the Return command will cause a line split
  4810.     at the current cursor position.
  4811.  
  4812.     The letter "I" will appear on the Status Line when this mode is ON.
  4813.  
  4814.                                3-22
  4815.  
  4816.  
  4817.     ToggleSmartTabs     <Ctrl QT>
  4818.     ─────────────────────────────────────────────────────────────────────────
  4819.  
  4820.     Toggles Smart Tabs ON and OFF.  If ON, the TabRt and TabLt commands
  4821.     will place the cursor beneath the beginning of the next (or
  4822.     previous) word on the line immediately above the current cursor
  4823.     line.  If the line immediately above the cursor line is blank, then
  4824.     the cursor will not move.
  4825.  
  4826.     Smart Tabs mode should NOT be set ON while C mode is ON.
  4827.  
  4828.  
  4829.     ToggleTabsExpand    <Alt V>
  4830.     ────────────────────────────────────────────────────────────────────────
  4831.  
  4832.     Toggles Physical Tab Expansion ON and OFF.  If ON, physical tab
  4833.     characters (ASCII 9's) found in a file will be expanded into spaces
  4834.     according to the Physical Tab Width set in the configuration
  4835.     program.  If OFF, physical tabs will be displayed on the screen and
  4836.     a physical tab character will be placed in the text each time the
  4837.     TabRt command is entered.
  4838.  
  4839.  
  4840.     ToggleTabsOut       <Alt I>
  4841.     ─────────────────────────────────────────────────────────────────────────
  4842.  
  4843.     Toggles Tabs Out mode ON and OFF.  If ON, continuous spaces in a
  4844.     line of text will be replaced with physical tabs (ASCII 9's)
  4845.     according to the Physical Tab Width set in the configuration
  4846.     program. Only spaces in edited lines are replaced with physical
  4847.     tabs. Spaces falling between single or double quotes will not be
  4848.     replaced.
  4849.  
  4850.  
  4851.     ToggleWordwrap      <Ctrl OW> or <Esc><O><W>
  4852.     ─────────────────────────────────────────────────────────────────────────
  4853.  
  4854.     Toggles WordWrap mode ON and OFF.  If ON, the cursor, along with the
  4855.     word currently being typed, will automatically advance to the next
  4856.     line whenever a character is typed beyond the right margin. The
  4857.     right margin can be permanently set using the configuration program
  4858.     (refer to the "General Options" section of Chapter 2 for more
  4859.     information) or temporarily changed using the SetRmargin command.
  4860.  
  4861.     The letter "W" will appear on the Status Line when this mode is ON.
  4862.  
  4863.  
  4864.     UndoCursorline      <Ctrl QL>
  4865.     ─────────────────────────────────────────────────────────────────────────
  4866.  
  4867.     Reverses any changes made to the current cursor line (except changes
  4868.     made with the FindReplace command).  If the cursor has been moved
  4869.     from the changed line or a file or window command is executed, the
  4870.     changes cannot be undone.
  4871.  
  4872.                                3-23
  4873.  
  4874.  
  4875.     UnKill              <Ctrl U> or <Esc><E><U>
  4876.     ─────────────────────────────────────────────────────────────────────────
  4877.  
  4878.     Recovers the last deleted entry from the current file's Kill Buffer.
  4879.     Deleted blocks and lines will be inserted immediately before the
  4880.     current cursor line and deleted words will be inserted immediately
  4881.     before the current cursor position.
  4882.  
  4883.     The number of lines saved in the Kill Buffer may be set with the
  4884.     configuration program.  Refer to the "General Options" section of
  4885.     Chapter 2 for more information.
  4886.  
  4887.  
  4888.     UnmarkBlock         <Alt U> or <Esc><B><U>
  4889.     ─────────────────────────────────────────────────────────────────────────
  4890.  
  4891.     Unmarks the currently marked Block.
  4892.  
  4893.  
  4894.     WordLeft            <Ctrl Cursor Left>
  4895.     ─────────────────────────────────────────────────────────────────────────
  4896.  
  4897.     Positions the cursor at the first character of the previous word.
  4898.  
  4899.  
  4900.     WordRight           <Ctrl Cursor Right>
  4901.     ─────────────────────────────────────────────────────────────────────────
  4902.  
  4903.     Positions the cursor at the first character of the following word.
  4904.  
  4905.  
  4906.     WrapPara            <Alt B>
  4907.     ─────────────────────────────────────────────────────────────────────────
  4908.  
  4909.     Reformats text from the current cursor position until a blank line
  4910.     or end of file is encountered.  If AutoIndent is ON, the line below
  4911.     the cursor line is used for the left margin.  Otherwise, a left
  4912.     margin of zero is used.  The right margin is determined by the
  4913.     configuration program or the SetRmargin command.
  4914.  
  4915.  
  4916.     WriteBlock          <Alt W> or <Alt F><W> or <Esc><F><W>
  4917.     ─────────────────────────────────────────────────────────────────────────
  4918.  
  4919.     Writes the currently marked Block to the named file.  The editor
  4920.     will prompt for the name of the file.
  4921.  
  4922.  
  4923.     ZoomWindow          <Ctrl OZ> or <Esc><W><Z>
  4924.     ─────────────────────────────────────────────────────────────────────────
  4925.  
  4926.     Toggles Zoom mode ON and OFF.  If there are multiple windows on the
  4927.     screen, entering the ZoomWindow command will cause the current
  4928.     window to fill the entire screen.  Pressing ZoomWindow again
  4929.     restores the other windows to the screen.
  4930.  
  4931.                                3-24
  4932.  
  4933.  
  4934.     Appendix A.  List of Commands
  4935.     =========================================================================
  4936.  
  4937.                                 ┌─────────────┐
  4938.                                 │ By Function │
  4939.                                 └─────────────┘
  4940.  
  4941.                              Menu (Esc)  Default                   Customized
  4942.     Command                  Sequence    Keystroke                 Keystroke
  4943.     ────────────────────     ──────────  ────────────────────      ──────────
  4944.  
  4945.     Cursor Movement
  4946.     ---------------
  4947.     BegFile                              Ctrl PgUp
  4948.     BegLine                              Home
  4949.     BegScreen                            Ctrl Home
  4950.     CursorDown                           Cursor Down
  4951.     CursorLeft                           Cursor Left
  4952.  
  4953.     CursorRight                          Cursor Right
  4954.     CursorUp                             Cursor Up
  4955.     EndFile                              Ctrl PgDn
  4956.     EndLine                              End
  4957.     EndScreen                            Ctrl End
  4958.  
  4959.     GotoBlockBeg                         Ctrl QB
  4960.     GotoBlockEnd                         Ctrl QK
  4961.     GotoLine                             Ctrl J
  4962.     HalfPgDn
  4963.     HalfPgUp
  4964.  
  4965.     LineDown
  4966.     LineUp
  4967.     MakeBotofScreen
  4968.     MakeCtrofScreen                      Shift F5
  4969.     MakeTopofScreen                      F5
  4970.  
  4971.                                A-1
  4972.  
  4973.  
  4974.     PageDown                             PgDn
  4975.     PageUp                               PgUp
  4976.     PrevPosition                         Ctrl QP
  4977.     ScreenLeft                           Alt  F5
  4978.     ScreenRight                          Alt  F6
  4979.  
  4980.     ScrollDown                           Ctrl Z
  4981.     ScrollUp                             Ctrl W
  4982.     WordLeft                             Ctrl Cursor Left
  4983.     WordRight                            Ctrl Cursor Right
  4984.  
  4985.  
  4986.     Editing
  4987.     -------
  4988.     AddLine                  EA          F2
  4989.     Align
  4990.     Backspace                            Backspace
  4991.     DelCh                                Del
  4992.     DelLine                  ED          Alt  D
  4993.  
  4994.     DelLtWord                            Ctrl Backspace
  4995.     DelRtWord                            Ctrl T
  4996.     DelToEol                 EE          F6
  4997.     DupLine                              F4
  4998.     GetPrev                              Ctrl - (dash)
  4999.  
  5000.     InsertLine               EI          Alt  F2
  5001.     JoinLine                 EJ          Alt  J
  5002.     Literal                              Ctrl P
  5003.     Return                               Enter
  5004.     SplitLine                ES          Alt  S
  5005.  
  5006.     UnKill                   EU          Ctrl U
  5007.  
  5008.  
  5009.     Block/Scratch Buffer
  5010.     --------------------
  5011.     AppendScrbuff                        Ctrl BA
  5012.     Copy                                 grey +
  5013.     CopyBlock                BC          Alt  C
  5014.     CopyOverBlock                        Alt  Z
  5015.     Cut                                  grey -
  5016.  
  5017.                                A-2
  5018.  
  5019.  
  5020.     DeleteBlock              BD          Alt  G
  5021.     DropAnchor                           Alt  A
  5022.     GetScrbuff                           Ctrl BL
  5023.     MarkBlockBegin           BB          Ctrl KB or F7
  5024.     MarkBlockEnd             BE          Ctrl KK or F8
  5025.  
  5026.     MarkCharacter
  5027.     MarkColumn                           Alt  K
  5028.     MarkLine                 BL          Alt  L
  5029.     MoveBlock                BM          Alt  M
  5030.     Paste                                grey *
  5031.  
  5032.     PasteOver                            Ctrl PrtSc
  5033.     ShiftLeft                            Shift F7
  5034.     ShiftRight                           Shift F8
  5035.     StoreScrbuff                         Ctrl BS
  5036.     UnmarkBlock              BU          Alt  U
  5037.  
  5038.  
  5039.     File
  5040.     ----
  5041.     ChangeFilename           FC          Alt  O  or Alt  F,C
  5042.     EditFile                 FL          Alt  E  or Alt  F,L
  5043.     Exit                                 Ctrl KD
  5044.     File                     FF          Ctrl KX or Alt  F,F
  5045.     GExit                    QX          Alt  X  or Alt  Q,X
  5046.  
  5047.     GFile                    FG          Alt  F,G
  5048.     GPQuit                   QQ          F3      or Alt  Q,Q
  5049.     GSave                                Alt  Y
  5050.     KillFile                             Ctrl KZ
  5051.     NextFile                 FN          Alt  N  or Alt  F,N
  5052.  
  5053.     PQuit                    FQ          Ctrl KQ or Alt  F,Q
  5054.     PrevFile                 FP          Ctrl KP or Alt  F,P
  5055.     Quit
  5056.     ReadBlock                FR          Alt  R  or Alt  F,R
  5057.     SaveFile                 FS          Ctrl KS or Alt  F,S
  5058.  
  5059.     WriteBlock               FW          Alt  W  or Alt  F,W
  5060.  
  5061.                                A-3
  5062.  
  5063.  
  5064.     Window
  5065.     ------
  5066.     CloseWindow              WC          Ctrl OC
  5067.     GrowWindow               WG          Ctrl OG
  5068.     HorizontalWindow         WS          Ctrl OH
  5069.     NextWindow               WN          Ctrl ON
  5070.     OneWindow                WO          Ctrl OO
  5071.  
  5072.     PrevWindow               WP          Ctrl OP
  5073.     ShrinkWindow             WR          Ctrl OS
  5074.     ZoomWindow               WZ          Ctrl OZ
  5075.  
  5076.  
  5077.     Macro
  5078.     -----
  5079.     CurrentFilename
  5080.     ExecuteScrap                         Ctrl Enter
  5081.     MacroRead                MR
  5082.     MacroRecord              MM          Ctrl M
  5083.     MacroWrite               MW
  5084.  
  5085.  
  5086.     Printing
  5087.     --------
  5088.     PrintAll                 PA          Alt  P,A
  5089.     PrintBlock               PB          Alt  P,B
  5090.     PrintEject               PF          Alt  P,F
  5091.     SetPrintLeftMargin       PL          Alt  P,L
  5092.     SetPrintPageSize         PP          Alt  P,P
  5093.  
  5094.  
  5095.     Tab
  5096.     ---
  5097.     SetCtabwidth             OC
  5098.     SetPtabwidth             OP
  5099.     TabLt                                Shift Tab
  5100.     TabRt                                Tab
  5101.  
  5102.                                A-4
  5103.  
  5104.  
  5105.     Find/Replace
  5106.     ------------
  5107.     Find                     SF          Ctrl QF
  5108.     FindReplace              SR          Ctrl QA
  5109.     RepeatFind               SA          Ctrl L
  5110.  
  5111.  
  5112.     Toggles
  5113.     -------
  5114.     ToggleBakups             OB
  5115.     ToggleBoxDraw                        Shift F1
  5116.     ToggleEnterMatching      OE
  5117.     ToggleIndent             OA          Ctrl QI
  5118.     ToggleInsert             OI          Ins
  5119.  
  5120.     ToggleSmartTabs                      Ctrl QT
  5121.     ToggleTabsExpand                     Alt  V
  5122.     ToggleTabsOut                        Alt  I
  5123.     ToggleWordwrap           OW          Ctrl OW
  5124.  
  5125.  
  5126.     Other
  5127.     -----
  5128.     Dos                                  Alt  F9
  5129.     Escape                               Escape
  5130.     InsertDate
  5131.     InsertTime
  5132.     MainMenu                             Escape
  5133.  
  5134.     Match                                Alt  F3
  5135.     QuickHelp                            Alt  H  or F1
  5136.     SetEGA25
  5137.     SetEGA43
  5138.     SetRmargin               OR          Ctrl OR
  5139.  
  5140.     Shell                    FO          F9      or Alt  F,O
  5141.     ShowEntryScreen                      Alt  F10
  5142.     ToggleEGA43                          Ctrl F1
  5143.     UndoCursorline                       Ctrl QL
  5144.     WrapPara                             Alt  B
  5145.  
  5146.                                A-5
  5147.  
  5148.                              ┌────────────────┐
  5149.                              │ Alphabetically │
  5150.                              └────────────────┘
  5151.  
  5152.                              Menu (Esc)  Default                   Customized
  5153.     Command                  Sequence    Keystroke                 Keystroke
  5154.     ────────────────────     ──────────  ────────────────────      ──────────
  5155.  
  5156.     AddLine                  EA          F2
  5157.     Align
  5158.     AppendScrbuff                        Ctrl BA
  5159.     Backspace                            Backspace
  5160.     BegFile                              Ctrl PgUp
  5161.  
  5162.     BegLine                              Home
  5163.     BegScreen                            Ctrl Home
  5164.     ChangeFilename           FC          Alt  O  or Alt  F,C
  5165.     CloseWindow              WC          Ctrl OC
  5166.     Copy                                 grey +
  5167.  
  5168.     CopyBlock                BC          Alt  C
  5169.     CopyOverBlock                        Alt  Z
  5170.     CurrentFilename
  5171.     CursorDown                           Cursor Down
  5172.     CursorLeft                           Cursor Left
  5173.  
  5174.     CursorRight                          Cursor Right
  5175.     CursorUp                             Cursor Up
  5176.     Cut                                  grey -
  5177.     DelCh                                Del
  5178.     DeleteBlock              BD          Alt  G
  5179.  
  5180.     DelLine                  ED          Alt  D
  5181.     DelLtWord                            Ctrl Backspace
  5182.     DelRtWord                            Ctrl T
  5183.     DelToEol                 EE          F6
  5184.     Dos                                  Alt  F9
  5185.  
  5186.     DropAnchor                           Alt  A
  5187.     DupLine                              F4
  5188.     EditFile                 FL          Alt  E  or Alt  F,L
  5189.     EndFile                              Ctrl PgDn
  5190.     EndLine                              End
  5191.  
  5192.     EndScreen                            Ctrl End
  5193.     Escape                               Escape
  5194.     ExecuteScrap                         Ctrl Enter
  5195.     Exit                                 Ctrl KD
  5196.     File                     FF          Ctrl KX or Alt  F,F
  5197.  
  5198.                                A-6
  5199.  
  5200.     Find                     SF          Ctrl QF
  5201.     FindReplace              SR          Ctrl QA
  5202.     GetPrev                              Ctrl - (dash)
  5203.     GetScrbuff                           Ctrl BL
  5204.     GExit                    QX          Alt  X  or Alt  Q,X
  5205.  
  5206.     GFile                    FG          Alt  F,G
  5207.     GotoBlockBeg                         Ctrl QB
  5208.     GotoBlockEnd                         Ctrl QK
  5209.     GotoLine                             Ctrl J
  5210.     GPQuit                   QQ          F3      or Alt  Q,Q
  5211.  
  5212.     GrowWindow               WG          Ctrl OG
  5213.     GSave                                Alt  Y
  5214.     HalfPgDn
  5215.     HalfPgUp
  5216.     HorizontalWindow         WS          Ctrl OH
  5217.  
  5218.     InsertDate
  5219.     InsertLine               EI          Alt  F2
  5220.     InsertTime
  5221.     JoinLine                 EJ          Alt  J
  5222.     KillFile                             Ctrl KZ
  5223.  
  5224.     LineDown
  5225.     LineUp
  5226.     Literal                              Ctrl P
  5227.     MacroRead                MR
  5228.     MacroRecord              MM          Ctrl M
  5229.  
  5230.     MacroWrite               MW
  5231.     MainMenu                             Escape
  5232.     MakeBotofScreen
  5233.     MakeCtrofScreen                      Shift F5
  5234.     MakeTopofScreen                      F5
  5235.  
  5236.     MarkBlockBegin           BB          Ctrl KB or F7
  5237.     MarkBlockEnd             BE          Ctrl KK or F8
  5238.     MarkCharacter
  5239.     MarkColumn                           Alt  K
  5240.     MarkLine                 BL          Alt  L
  5241.  
  5242.                                A-7
  5243.  
  5244.     Match                                Alt  F3
  5245.     MoveBlock                BM          Alt  M
  5246.     NextFile                 FN          Alt  N  or Alt  F,N
  5247.     NextWindow               WN          Ctrl ON
  5248.     OneWindow                WO          Ctrl OO
  5249.  
  5250.     PageDown                             PgDn
  5251.     PageUp                               PgUp
  5252.     Paste                                grey *
  5253.     PasteOver                            Ctrl PrtSc
  5254.     PQuit                    FQ          Ctrl KQ or Alt  F,Q
  5255.  
  5256.     PrevFile                 FP          Ctrl KP or Alt  F,P
  5257.     PrevPosition                         Ctrl QP
  5258.     PrevWindow               WP          Ctrl OP
  5259.     PrintAll                 PA          Alt  P,A
  5260.     PrintBlock               PB          Alt  P,B
  5261.  
  5262.     PrintEject               PF          Alt  P,F
  5263.     QuickHelp                            Alt  H  or F1
  5264.     Quit
  5265.     ReadBlock                FR          Alt  R  or Alt  F,R
  5266.     RepeatFind               SA          Ctrl L
  5267.  
  5268.     Return                               Enter
  5269.     SaveFile                 FS          Ctrl KS or Alt  F,S
  5270.     ScreenLeft                           Alt  F5
  5271.     ScreenRight                          Alt  F6
  5272.     ScrollDown                           Ctrl Z
  5273.  
  5274.     ScrollUp                             Ctrl W
  5275.     SetCtabwidth             OC
  5276.     SetEGA25
  5277.     SetEGA43
  5278.     SetPrintLeftMargin       PL          Alt  P,L
  5279.  
  5280.     SetPrintPageSize         PP          Alt  P,P
  5281.     SetPtabwidth             OP
  5282.     SetRmargin               OR          Ctrl OR
  5283.     Shell                    FO          F9      or Alt  F,O
  5284.     ShiftLeft                            Shift F7
  5285.  
  5286.                                A-8
  5287.  
  5288.     ShiftRight                           Shift F8
  5289.     ShowEntryScreen                      Alt  F10
  5290.     ShrinkWindow             WR          Ctrl OS
  5291.     SplitLine                ES          Alt  S
  5292.     StoreScrbuff                         Ctrl BS
  5293.  
  5294.     TabLt                                Shift Tab
  5295.     TabRt                                Tab
  5296.     ToggleBakups             OB
  5297.     ToggleBoxDraw                        Shift F1
  5298.     ToggleEGA43                          Ctrl F1
  5299.  
  5300.     ToggleEnterMatching      OE
  5301.     ToggleIndent             OA          Ctrl QI
  5302.     ToggleInsert             OI          Ins
  5303.     ToggleSmartTabs                      Ctrl QT
  5304.     ToggleTabsExpand                     Alt  V
  5305.  
  5306.     ToggleTabsOut                        Alt  I
  5307.     ToggleWordwrap           OW          Ctrl OW
  5308.     UndoCursorline                       Ctrl QL
  5309.     UnKill                   EU          Ctrl U
  5310.     UnmarkBlock              BU          Alt  U
  5311.  
  5312.     WordLeft                             Ctrl Cursor Left
  5313.     WordRight                            Ctrl Cursor Right
  5314.     WrapPara                             Alt  B
  5315.     WriteBlock               FW          Alt  W  or Alt  F,W
  5316.     ZoomWindow               WZ          Ctrl OZ
  5317.  
  5318.                                A-9
  5319.  
  5320.  
  5321.     Appendix B.  List of Configurable Keys
  5322.     =========================================================================
  5323.  
  5324.                                ┌───────────────┐
  5325.                                │ Function Keys │
  5326.                                └───────────────┘
  5327.  
  5328.     Keystroke      Default Command     │  Keystroke          Default Command
  5329.     ─────────      ───────────────     │  ─────────          ───────────────
  5330.     F1             QuickHelp           │  Shift F1           ToggleBoxDraw
  5331.     F2             AddLine             │  Shift F2
  5332.     F3             GPQuit              │  Shift F3
  5333.     F4             DupLine             │  Shift F4
  5334.     F5             MakeTopofScreen     │  Shift F5           MakeCtrofScreen
  5335.                                        │
  5336.     F6             DelToEol            │  Shift F6
  5337.     F7             MarkBlockBegin      │  Shift F7           ShiftLeft
  5338.     F8             MarkBlockEnd        │  Shift F8           ShiftRight
  5339.     F9             Shell               │  Shift F9
  5340.     F10                                │  Shift F10
  5341.     ───────────────────────────────────┼────────────────────────────────────────
  5342.     Ctrl F1        ToggleEGA43         │  Alt F1
  5343.     Ctrl F2                            │  Alt F2             InsertLine
  5344.     Ctrl F3                            │  Alt F3             Match
  5345.     Ctrl F4                            │  Alt F4
  5346.     Ctrl F5                            │  Alt F5             ScreenLeft
  5347.                                        │
  5348.     Ctrl F6                            │  Alt F6             ScreenRight
  5349.     Ctrl F7                            │  Alt F7
  5350.     Ctrl F8                            │  Alt F8
  5351.     Ctrl F9                            │  Alt F9             Dos
  5352.     Ctrl F10                           │  Alt F10            ShowEntryScreen
  5353.  
  5354.                                B-1
  5355.  
  5356.                            ┌──────────────────────┐
  5357.                            │ Special Purpose Keys │
  5358.                            └──────────────────────┘
  5359.  
  5360.     Keystroke      Default Command     │  Keystroke          Default Command
  5361.     ─────────      ───────────────     │  ─────────          ───────────────
  5362.     Backspace      Backspace           │  Ctrl Backspace     DelLtWord
  5363.     Cursor down    CursorDown          │
  5364.     Cursor left    CursorLeft          │  Ctrl Cursor left   WordLeft
  5365.     Cursor right   CursorRight         │  Ctrl Cursor right  WordRight
  5366.     Cursor up      CursorUp            │
  5367.                                        │
  5368.     Del            DelCh               │  Shift Del
  5369.     End            EndLine             │  Ctrl End           EndScreen
  5370.     Enter          Return              │  Ctrl Enter        ExecuteScrap
  5371.     Escape         Escape              │
  5372.     grey *         Paste               │
  5373.                                        │
  5374.     grey +         Copy                │
  5375.     grey -         Cut                 │
  5376.     Home           BegLine             │  Ctrl Home          BegScreen
  5377.     Ins            ToggleInsert        │  Shift Ins
  5378.     PgDn           PageDown            │  Ctrl PgDn          EndFile
  5379.                                        │
  5380.     PgUp           PageUp              │  Ctrl PgUp          BegFile
  5381.     Tab            TabRt               │  Shift Tab          TabLt
  5382.     `                                  │
  5383.     /                                  │
  5384.     ~ (tilde)                          │
  5385.                                        │
  5386.                                        │  Ctrl PrtSc         PasteOver
  5387.                                        │  Ctrl [
  5388.                                        │  Ctrl ]
  5389.                                        │  Ctrl -             GetPrev
  5390.                                        │  Ctrl \
  5391.                                        │  Ctrl 2
  5392.                                        │  Ctrl 6
  5393.  
  5394.                                B-2
  5395.  
  5396.                                 ┌──────────────┐
  5397.                                 │ Control Keys │
  5398.                                 └──────────────┘
  5399.  
  5400.  
  5401.     Keystroke      Default Command     │  Keystroke          Default Command
  5402.     ─────────      ───────────────     │  ─────────          ───────────────
  5403.     Ctrl A         WordLeft            │  Ctrl P             Literal
  5404.   * Ctrl BA        AppendScrbuff       │* Ctrl QA            FindReplace
  5405.     Ctrl BL        GetScrbuff          │  Ctrl QB            GotoBlockBeg
  5406.     Ctrl BS        StoreScrbuff        │  Ctrl QC            EndFile
  5407.     Ctrl C         PageDown            │  Ctrl QD            EndLine
  5408.                                        │
  5409.     Ctrl D         CursorRight         │  Ctrl QE            BegScreen
  5410.     Ctrl E         CursorUp            │  Ctrl QF            Find
  5411.     Ctrl F         WordRight           │  Ctrl QI            ToggleIndent
  5412.     Ctrl G         DelCh               │  Ctrl QK            GotoBlockEnd
  5413.     Ctrl H         Backspace           │  Ctrl QL            UndoCursorline
  5414.                                        │
  5415.     Ctrl I         TabRt               │  Ctrl QP            PrevPosition
  5416.     Ctrl J         GotoLine            │  Ctrl QR            BegFile
  5417.   * Ctrl KB        MarkBlockBegin      │  Ctrl QS            BegLine
  5418.     Ctrl KC        CopyBlock           │  Ctrl QT            ToggleSmartTabs
  5419.     Ctrl KD        Exit                │  Ctrl QX            EndScreen
  5420.                                        │
  5421.     Ctrl KE        EditFile            │  Ctrl QY            DelToEol
  5422.     Ctrl KF        ChangeFilename      │  Ctrl R             PageUp
  5423.     Ctrl KH        UnmarkBlock         │  Ctrl S             CursorLeft
  5424.     Ctrl KK        MarkBlockEnd        │  Ctrl T             DelRtWord
  5425.     Ctrl KN        NextFile            │  Ctrl U             UnKill
  5426.                                        │
  5427.     Ctrl KP        PrevFile            │  Ctrl V             ToggleInsert
  5428.     Ctrl KQ        PQuit               │  Ctrl W             ScrollUp
  5429.     Ctrl KR        ReadBlock           │  Ctrl X             CursorDown
  5430.     Ctrl KS        SaveFile            │  Ctrl Y             DelLine
  5431.     Ctrl KT        ToggleTabsExpand    │  Ctrl Z             ScrollDown
  5432.                                        │
  5433.     Ctrl KV        MoveBlock           │
  5434.     Ctrl KW        WriteBlock          │
  5435.     Ctrl KX        File                │
  5436.     Ctrl KY        DeleteBlock         │
  5437.     Ctrl KZ        KillFile            │
  5438.                                        │
  5439.     Ctrl L         RepeatFind          │
  5440.     Ctrl M         MacroRecord         │
  5441.     Ctrl N         SplitLine           │
  5442.   * Ctrl OC        CloseWindow         │
  5443.     Ctrl OG        GrowWindow          │
  5444.                                        │
  5445.                                B-3
  5446.  
  5447.     Ctrl OH        HorizontalWindow    │
  5448.     Ctrl OL        SetPrintLeftMargin  │
  5449.     Ctrl ON        NextWindow          │
  5450.     Ctrl OO        OneWindow           │
  5451.     Ctrl OP        PrevWindow          │
  5452.                                        │
  5453.     Ctrl OR        SetRmargin          │
  5454.     Ctrl OS        ShrinkWindow        │
  5455.     Ctrl OW        ToggleWordwrap      │
  5456.     Ctrl OZ        ZoomWindow          │
  5457.  
  5458.   * QEdit allows you to assign commands to "twokey" combinations. A
  5459.     twokey consists of two distinct keystrokes, such as <Ctrl B>
  5460.     immediately followed by <A>.  Please note that keystrokes such as
  5461.     <Ctrl A> and <Alt C> by themselves each count as only one keystroke,
  5462.     just as <shift F1> is only one keystroke.  You cannot assign a QEdit
  5463.     command to a key which is already being used as the first keystroke
  5464.     of a twokey.
  5465.  
  5466.                                B-4
  5467.  
  5468.                                ┌────────────────┐
  5469.                                │ Alternate Keys │
  5470.                                └────────────────┘
  5471.  
  5472.  
  5473.     Keystroke    Default Command        │  Keystroke         Default Command
  5474.     ─────────    ───────────────        │  ─────────         ───────────────
  5475.     Alt A        DropAnchor             │  Alt 1
  5476.     Alt B        WrapPara               │  Alt 2
  5477.     Alt C        CopyBlock              │  Alt 3
  5478.     Alt D        DelLine                │  Alt 4
  5479.     Alt E        EditFile               │  Alt 5
  5480.                                         │
  5481.     Alt F        MacroBegin MainMenu 'f'│  Alt 6
  5482.     Alt G        DeleteBlock            │  Alt 7
  5483.     Alt H        QuickHelp              │  Alt 8
  5484.     Alt I        ToggleTabsOut          │  Alt 9
  5485.     Alt J        JoinLine               │  Alt 0
  5486.                                         │
  5487.     Alt K        MarkColumn             │  Alt -
  5488.     Alt L        MarkLine               │  Alt =
  5489.     Alt M        MoveBlock              │
  5490.     Alt N        NextFile               │
  5491.     Alt O        ChangeFilename         │
  5492.                                         │
  5493.     Alt P        MacroBegin MainMenu 'p'│
  5494.     Alt Q        MacroBegin MainMenu 'q'│
  5495.     Alt R        ReadBlock              │
  5496.     Alt S        SplitLine              │
  5497.     Alt T                               │
  5498.                                         │
  5499.     Alt U        UnmarkBlock            │
  5500.     Alt V        ToggleTabsExpand       │
  5501.     Alt W        WriteBlock             │
  5502.     Alt X        GExit                  │
  5503.     Alt Y        GSave                  │
  5504.                                         │
  5505.     Alt Z        CopyOverBlock          │
  5506.  
  5507.                                B-5
  5508.  
  5509.                           ┌────────────────────────┐
  5510.                           │ Enhanced Keyboard Keys │
  5511.                           └────────────────────────┘
  5512.  
  5513.     Keystroke      Default Command     │  Keystroke          Default Command
  5514.     ─────────      ───────────────     │  ─────────          ───────────────
  5515.     F11                                │  Alt F11
  5516.     F12                                │  Alt F12
  5517.     Shift F11                          │  Alt '
  5518.     Shift F12                          │  Alt ,
  5519.     Ctrl F11                           │  Alt .
  5520.                                        │
  5521.     Ctrl F12                           │  Alt /
  5522.     Ctrl Center Cursor                 │  Alt \
  5523.     Ctrl Cursor Down                   │  Alt ;
  5524.     Ctrl Cursor Up                     │  Alt [
  5525.     Ctrl Del                           │  Alt ]
  5526.                                        │
  5527.     Ctrl grey *                        │  Alt `
  5528.     Ctrl grey +                        │  Alt Backspace
  5529.     Ctrl grey -                        │  Alt Enter
  5530.     Ctrl grey /                        │  Alt Escape
  5531.     Ctrl Ins                           │  Alt grey *
  5532.                                        │
  5533.     Ctrl Tab                           │  Alt grey +
  5534.     Center Cursor                      │  Alt grey -
  5535.     grey Enter                         │  Alt grey /
  5536.     Ctrl grey Enter                    │  Alt grey Cursor Down
  5537.                                        │  Alt grey Cursor Left
  5538.                                        │
  5539.                                        │  Alt grey Cursor Right
  5540.                                        │  Alt grey Cursor Up
  5541.                                        │  Alt grey Del
  5542.                                        │  Alt grey End
  5543.                                        │  Alt grey Home
  5544.                                        │
  5545.                                        │  Alt grey Ins
  5546.                                        │  Alt grey PgDn
  5547.                                        │  Alt grey PgUp
  5548.                                        │  Alt grey Enter
  5549.                                        │  Alt Tab
  5550.  
  5551.  
  5552.     A list of all configurable keys is also contained in the QCONFIG.DAT
  5553.     file on the QEdit distribution diskette.
  5554.  
  5555.  
  5556.                                B-6
  5557.  
  5558.  
  5559.     Appendix C.  Error Messages
  5560.     =========================================================================
  5561.  
  5562.     This Appendix contains an alphabetical list of the error messages
  5563.     that can be displayed by QEdit.  Each message has a description and,
  5564.     as required, a resolution.  There is a separate list for QCONFIG
  5565.     (the configuration program) error messages.
  5566.  
  5567.  
  5568.     QEdit Error Messages
  5569.     ─────────────────────────────────────────────────────────────────────────
  5570.  
  5571.     Can't execute scrap macro when macro recording on:  The ExecuteScrap
  5572.     command cannot be used during macro recording.
  5573.  
  5574.     Disk full:  A disk full condition was encountered while trying to
  5575.     save a file.
  5576.     Resolution:  Temporarily exit to DOS using the Shell command and
  5577.     remove some files on the full disk, OR use the KillFile command to
  5578.     remove the currently edited file from disk, OR use the
  5579.     ChangeFilename command to direct the file to a different disk drive
  5580.     designation.
  5581.  
  5582.     Error creating file:  The filename specified on the command line is
  5583.     either an invalid DOS filename or there are no files matching the
  5584.     wildcarded specification.
  5585.     Resolution:  Enter a valid DOS filename or valid wildcarded designation
  5586.     on the command line when executing QEdit.
  5587.  
  5588.     Error running program:  DOS returned an error condition when
  5589.     QEdit attempted to perform the DOS EXEC function to load and execute
  5590.     a program and/or the DOS SHELL.
  5591.     Resolution:  Check these possible causes: there is not enough memory
  5592.     to load the external program, OR the COMMAND.COM file is not
  5593.     available, OR the COMSPEC environment variable is not set properly.
  5594.     Refer to your DOS manual for more information on the COMSPEC
  5595.     environment variable.
  5596.  
  5597.     Error opening file:  The file specified cannot be opened.
  5598.     Resolution:  Check for possible disk errors or failure.
  5599.  
  5600.     Error reading file:  The file specified cannot be read.
  5601.     Resolution:  Check for possible disk errors or failure.
  5602.  
  5603.                                C-1
  5604.  
  5605.     Error renaming file:  The file specified cannot be renamed.
  5606.     Resolution:  Check for possible disk errors or failure.
  5607.  
  5608.     Error writing file:  The file specified cannot be saved.
  5609.     Resolution:  Check for possible disk errors or failure.
  5610.  
  5611.     File not found:  The file specified in response to the MacroRead or
  5612.     ReadBlock command could not be found on disk.
  5613.     Resolution:  Check for the correct name of the file to read.
  5614.  
  5615.     Filename already in use in ring:  The file specified in response to
  5616.     the ChangeFilename command is already loaded into the editor.
  5617.     Resolution:  Enter a filename that is not already loaded into the
  5618.     editor.  If you are attempting to "jump" to another file in the
  5619.     ring, use the EditFile command.
  5620.  
  5621.     Invalid macro filesize:  An attempt was made to load a macro file
  5622.     using the MacroRead command, which is either too large or is not
  5623.     a valid macro file.
  5624.     Resolution:  Check for the correct name of the macro file to read.
  5625.  
  5626.     Key already defined:  An attempt was made to assign a
  5627.     macro to a key which already has a command assignment.
  5628.     Resolution:  Refer to Appendix B and select a key which does not
  5629.     already have a command assignment.
  5630.  
  5631.     Long lines split:  An attempt was made to load a file whose line
  5632.     length exceeded the QEdit limit of 512 characters.
  5633.     Resolution:  The file can still be edited, but be aware that all
  5634.     lines exceeding 512 characters will be split into shorter lines.
  5635.  
  5636.     Macro table full:  There is no more room to record macros.
  5637.     Resolution:  Delete some unused macros.
  5638.  
  5639.     Macro too long - Aborted:  The macro being created during macro
  5640.     recording has exceeded the maximum length.
  5641.     Resolution:  Keep macros to less than 250 consecutive "entries".  Note
  5642.     that during macro recording each QEdit command takes up 1 of these
  5643.     entries and each keyboard character takes up 2 entries.
  5644.  
  5645.     Match not found:  No match was found for "(", "{", or "[" characters
  5646.     when using the Match command.
  5647.  
  5648.     Memory lost to sub-process:  A memory-resident program (TSR) was
  5649.     executed using the QEdit Dos or Shell command and has procured
  5650.     memory that was in use by the editor.
  5651.     Resolution:  Immediately SAVE any files you are editing and re-boot
  5652.     your system.
  5653.  
  5654.                                C-2
  5655.  
  5656.     No files found:  An invalid wildcarded filename was entered in
  5657.     response to a QEdit "file(s) to edit" prompt.
  5658.     Resolution:  Check for the correct filename(s) to edit.
  5659.  
  5660.     Not enough memory to load entire file:  There is not enough memory to
  5661.     load the requested file into the editor.
  5662.     Resolution:  Split the requested file into separate files.
  5663.  
  5664.     Not enough memory:  There is not enough memory to continue editing
  5665.     the current file.
  5666.     Resolution:  Split the current file into separate files.
  5667.  
  5668.     Printer error:  An error was encountered while attempting to direct
  5669.     an edit file to the printer.
  5670.     Resolution:  Check to see that the printer is powered on, online, and
  5671.     properly connected to the computer.
  5672.  
  5673.     Press any key to continue:  The editor has displayed a message and
  5674.     will not continue until instructed.
  5675.  
  5676.  
  5677.     QCONFIG Error Messages
  5678.     ─────────────────────────────────────────────────────────────────────────
  5679.  
  5680.     invalid response - try again:  An invalid parameter was entered in
  5681.     response to a configuration option.
  5682.     Resolution:  Reread option and enter valid parameter.
  5683.  
  5684.     ERROR!!! Help buffer overflow in help.txt at line #:  The Help
  5685.     file contains more than 1800 non-blank characters.
  5686.     Resolution:  Edit the Help file and reduce the number of non-blank
  5687.     characters.
  5688.  
  5689.     Help filename xxxxxxxx.xxx NOT found:  The specified name of the Help
  5690.     file can not be found on disk.
  5691.     Resolution:  Check for the correct name of the Help file.
  5692.  
  5693.     Unexpected End Of File encountered at line #:   There is a problem
  5694.     with the format of the Help file - possibly corrupted.
  5695.     Resolution:  Load the Help file into QEdit and enter the SaveFile
  5696.     command.
  5697.  
  5698.     Line # too long:  The specified line in the Help file exceeds the
  5699.     maximum length of 80 characters.
  5700.     Resolution:  Edit the Help file and ensure that no lines exceed 80
  5701.     characters in length.
  5702.  
  5703.                                C-3
  5704.  
  5705.     FATAL ERROR:  macro too long at line #:  The macro at the specified
  5706.     line number in the Keyboard Definition file exceeds the maximum
  5707.     length of 255 characters.
  5708.     Resolution:  Edit the Keyboard Definition file and ensure that no
  5709.     macros exceed 255 characters in length.
  5710.  
  5711.     FATAL ERROR:  unrecognized command xxxx at line #:  The Keyboard
  5712.     Definition file contains an invalid command at the specified line
  5713.     number.
  5714.     Resolution:  Edit the Keyboard Definition file and correct the
  5715.     invalid command.
  5716.  
  5717.     FATAL ERROR:  macro table full at line #:  There is no more room left
  5718.     in the Keyboard Definition file for macros.
  5719.     Resolution:  Delete some unused macros.
  5720.  
  5721.     FATAL ERROR:  too many twokey definitions, aborted at line #:  The
  5722.     maximum number of twokey assignments in the Keyboard Definition file
  5723.     has been exceeded.
  5724.     Resolution:  Edit the Keyboard Definition file and reduce the number
  5725.     of twokey assignments.  Generally, there can be 30 to 50 twokey
  5726.     assignments, depending on the number of unique first keys.  The more
  5727.     unique first keys there are, the fewer twokey assignments can be
  5728.     made.
  5729.  
  5730.     FATAL ERROR:  invalid second key code xx at line #:  The Keyboard
  5731.     Definition file contains an invalid second key (of a twokey
  5732.     assignment) at the specified line number.
  5733.     Resolution:  Edit the Keyboard Definition file and correct the
  5734.     invalid key.
  5735.  
  5736.     FATAL ERROR:  macro_begin not supported for twokey commands, line #:
  5737.     Macros cannot be assigned to twokeys.
  5738.  
  5739.     FATAL ERROR:  return bound to twokey at line #:  The Return command
  5740.     cannot be assigned to a twokey.
  5741.  
  5742.     FATAL ERROR:  escape bound to twokey at line #:  The Escape command
  5743.     cannot be assigned to a twokey.
  5744.  
  5745.     FATAL ERROR:  undefined key xxxx encountered at line #:   The Keyboard
  5746.     Definition file contains an invalid configurable key at the specified
  5747.     line number.
  5748.     Resolution:  Edit the Keyboard Definition file and correct the
  5749.     invalid key.
  5750.  
  5751.     FATAL ERROR:  return command MUST be "bound" to a key:  The Return
  5752.     command is not assigned to any key in the Keyboard Definition file.
  5753.     Resolution:  Assign the Return command to some configurable key in
  5754.     the Keyboard Definition file.
  5755.  
  5756.                                C-4
  5757.  
  5758.     FATAL ERROR:  escape command MUST be "bound" to a key:  The Escape
  5759.     command is not assigned to any key in the Keyboard Definition file.
  5760.     Resolution:  Assign the Escape command to some configurable key in
  5761.     the Keyboard Definition file.
  5762.  
  5763.     File xxxxxxxx.xxx not found:  The specified name of the Keyboard
  5764.     Definition file can not be found on disk.
  5765.     Resolution:  Check for the correct name of the Keyboard Definition
  5766.     file.
  5767.  
  5768.     FATAL ERROR:  xxxxxxxx.xxx not found:  The specified name of the
  5769.     QEdit executable file cannot be found on disk.
  5770.     Resolution:  Check for the correct name of the QEdit executable file.
  5771.  
  5772.     FATAL ERROR:  patch area NOT found:  There is a problem with the QEdit
  5773.     executable file (Q.EXE or copy of same).
  5774.     Resolution:  Reload the QEdit (Q.EXE) and QCONFIG.EXE executable
  5775.     files from the QEdit distribution disk.
  5776.  
  5777.     FATAL ERROR:  end of patch area NOT found.  There is a problem with
  5778.     the QEdit executable file (Q.EXE or copy of same).
  5779.     Resolution: Reload the QEdit (Q.EXE) and QCONFIG.EXE executable
  5780.     files from the QEdit distribution disk.
  5781.  
  5782.  
  5783.                                C-5
  5784.  
  5785.  
  5786.     Appendix D.  Commonly Used Macros
  5787.     =========================================================================
  5788.  
  5789.     We have received many useful suggestions from QEdit users over the
  5790.     years.  Since the introduction of macros in version 2.00, we have
  5791.     received ideas for some very helpful macros.  Here is a short list
  5792.     of some of the more useful (and simple) macros.
  5793.  
  5794.  
  5795.     ■ By default, QEdit's AddLine and DelLine commands do not change the
  5796.       cursor position.  Many would prefer that the cursor move to column
  5797.       one when these commands are executed.  A solution is to change the
  5798.       QCONFIG.DAT file (and reload using QCONFIG.EXE) as follows:
  5799.  
  5800.       Default QCONFIG.DAT file:
  5801.  
  5802.       f2    AddLine
  5803.       ^y    DelLine
  5804.  
  5805.       Customized QCONFIG.DAT file:
  5806.  
  5807.       f2    MacroBegin AddLine BegLine
  5808.       ^y    MacroBegin DelLine BegLine
  5809.  
  5810.  
  5811.     ■ By default, QEdit's CopyBlock and MoveBlock commands leave the
  5812.       copied or moved block marked.  Many would prefer for the block to
  5813.       be unmarked.  A solution is to change the QCONFIG.DAT file (and
  5814.       reload using QCONFIG.EXE) as follows:
  5815.  
  5816.       Default QCONFIG.DAT file:
  5817.  
  5818.       @c    CopyBlock
  5819.       @m    MoveBlock
  5820.  
  5821.       Customized QCONFIG.DAT file:
  5822.  
  5823.       @c    MacroBegin CopyBlock UnmarkBlock
  5824.       @m    MacroBegin MoveBlock UnmarkBlock
  5825.  
  5826.  
  5827.                                D-1
  5828.  
  5829.     ■ By default, QEdit's ReadBlock command inserts a file from disk at
  5830.       the current cursor position.  To have QEdit insert files on the
  5831.       line immediately following the current cursor line, change the
  5832.       QCONFIG.DAT file (and reload using QCONFIG.EXE) as follows:
  5833.  
  5834.       Default QCONFIG.DAT file:
  5835.  
  5836.       @r    ReadBlock
  5837.  
  5838.       Customized QCONFIG.DAT file:
  5839.  
  5840.       @r    MacroBegin EndLine SplitLine CursorDown BegLine ReadBlock
  5841.             GotoBlockEnd JoinLine GotoBlockBeg
  5842.  
  5843.  
  5844.     ■ By default, QEdit's DropAnchor command will end or extend a block
  5845.       if executed after a Block has been initially or entirely marked.
  5846.       Some editors have a similar command, except that it acts as a
  5847.       toggle.  That is, if you are already marking a Block, and you
  5848.       press DropAnchor again, the Block is unmarked and marking begins
  5849.       again at the current cursor position.  To implement, change the
  5850.       QCONFIG.DAT file (and reload using QCONFIG.EXE) as follows:
  5851.  
  5852.       Default QCONFIG.DAT file:
  5853.  
  5854.       @a    DropAnchor
  5855.  
  5856.       Customized QCONFIG.DAT file:
  5857.  
  5858.       @a    MacroBegin UnmarkBlock DropAnchor
  5859.  
  5860.  
  5861.     ■ A very useful QEdit command, GetPrev, will copy a character from
  5862.       the line immediately above the cursor line, onto the cursor line.
  5863.       Many times, it may be necessary to copy this character to several
  5864.       succeeding lines in the same column.  The GetPrev command, used in
  5865.       a macro, makes this function easy.  We will assign the macro to
  5866.       the <Alt 1> key (@1 in QEdit's terminology).
  5867.  
  5868.       @1    MacroBegin GetPrev CursorLeft CursorDown
  5869.  
  5870.  
  5871.     ■ This macro will allow you to edit a sorted list of files of the
  5872.       current directory.
  5873.  
  5874.       @1    MacroBegin Dos "dir *.* | sort>filedir.tmp" Return Return
  5875.             EditFile "filedir.tmp" Return DelLine DelLine DelLine DelLine
  5876.  
  5877.                                D-2
  5878.  
  5879.  
  5880.     Appendix E.  The Author
  5881.     =========================================================================
  5882.  
  5883.     Sammy Mitchell is a native of Atlanta, Georgia.  He graduated from
  5884.     Georgia State University in 1980 with a degree in Information
  5885.     Systems. Since college he has worked for Southern Company Services
  5886.     as a programmer analyst and for Equitable Real Estate Investment
  5887.     Management as a VM systems programmer. In 1986 he went into
  5888.     full-time consulting, specializing in systems and applications work
  5889.     on Micros and Mainframes in assembler, C and Pascal.  Besides QEdit,
  5890.     he is also the co-author of Mach 2 for Turbo Pascal, LXEDIT (a
  5891.     "large file" front-end for IBM's VM/CMS SP XEDIT), and a host of
  5892.     productivity aids at both Southern Company and Equitable. When he's
  5893.     away from the computer (which is very seldom these days) he enjoys
  5894.     lifting weights, playing softball, and spending quiet evenings with
  5895.     his wife.
  5896.  
  5897.  
  5898.                                E-1
  5899.  
  5900.  
  5901.     (index not available in disk manual)
  5902.  
  5903.